Skip to content

Commit fce4edc

Browse files
Merge pull request #1353 from pao/topic/CONTRIBUTING
Add a CONTRIBUTING file
2 parents 2338c71 + 163fa86 commit fce4edc

File tree

1 file changed

+51
-0
lines changed

1 file changed

+51
-0
lines changed

CONTRIBUTING.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Contributing
2+
3+
We welcome contributions to Julia and appreciate your interest. There are capabilities to grow, interfaces to write, and bugs to squish. Area experts may contribute by writing software that supports work in their own field. To keep things percolating as smoothly as possible, we ask that you follow the advice and guidelines given here.
4+
5+
## ready, get set
6+
7+
Before contributing to Julia, you should join the [dev list](https://groups.google.com/forum/?fromgroups#!forum/julia-dev), read the user manual and library guide, and create a free GitHub account. Follow these steps to get Julia copied to your machine in a way that lets you to work locally, rewind your edits, keep a remote backup, and safely contribute to Julia.
8+
9+
* Join the [dev list](https://groups.google.com/forum/?fromgroups#!forum/julia-dev)
10+
11+
* Create a [GitHub account](https://github.com/signup/free)
12+
13+
* [Fork Julia](https://github.com/JuliaLang/julia/fork_select)
14+
15+
* Build the software and libraries (the first time takes time)
16+
<p>
17+
Detailed build instructions are in the [README](https://github.com/JuliaLang/julia/tree/master/README.md). Julia depends on several external packages; most are automatically downloaded and installed, but are less frequently updated than Julia itself.
18+
</p>
19+
20+
* Keep Julia current
21+
<p>
22+
Julia is a fast-moving target, and many details of the language are still settling out. Keeping your repository up to date and rebasing your work in progress requently
23+
</p>
24+
25+
* Relax
26+
27+
## submitting your contributions
28+
29+
The Julia team uses the [GitHub issue tracker](https://github.com/JuliaLang/julia/issues) for accepting pull requests. Note that by contributing, you are agreeing to release your code under the [MIT License](https://github.com/JuliaLang/julia/tree/master/LICENSE.md).
30+
31+
You can make pull requests for incomplete features to get code review. Please prefix your pull request title with "RFC:" to indicate that the work is incomplete so it doesn't accidentally get pulled early.
32+
33+
Before submitting, please make sure that all tests pass by running `make testall`. Even better, add your own tests for your change or feature to the test files in `tests/`. If your contribution includes changes to Makefiles or external dependencies, make sure you can build Julia from a clean tree using `git clean -fdx` or equivalent.
34+
35+
## getting help
36+
While getting familiar with Julia, and when using unfamiliar aspects of the language, the first recourse is to take advantage of the [docs](http://docs.julialang.org/en/latest/). When [searching the docs](http://docs.julialang.org/en/latest/search/), if you use a script blocker then you must unblock the page. The [source code](https://github.com/JuliaLang/julia) is an excellent source of examples. Use the [dev list](https://groups.google.com/forum/?fromgroups#!forum/julia-dev) as a resource whenever you are stumped or curious or in need of other feedback. It is always a good idea to search the dev list before posting -- there is already guidance helpful for common questions.
37+
38+
# resources
39+
40+
* Julia
41+
- [Julia](http://julialang.org)
42+
- [Julia Manual and Library Guide](http://docs.julialang.org/en/latest/)
43+
- [Julia dev list](https://groups.google.com/forum/?fromgroups#!forum/julia-dev)
44+
* Working with Types
45+
- [Some Type Patterns](https://github.com/JuliaLang/julia/wiki/Code-Patterns)
46+
- [The Type Hierarchy](https://github.com/JuliaLang/julia/wiki/Types-Hierarchy)
47+
* Using GitHub
48+
- [Using Julia with GitHub (video)](http://www.youtube.com/watch?v=wnFYV3ZKtOg&feature=youtu.be)
49+
- [Using Julia on GitHub (notes for video)](https://gist.github.com/2712118#file_julia_git_pull_request.md)
50+
- [General GitHub documentation](http://help.github.com/)
51+
- [GitHub pull request documentation](http://help.github.com/send-pull-requests/)

0 commit comments

Comments
 (0)