2014-03-29 17:36:16 +00:00
|
|
|
Please do contribute! If you want to contribute but are unsure where to
|
|
|
|
start, the [Contributions Needed
|
2014-04-30 13:14:42 +00:00
|
|
|
topic](http://discourse.syncthing.net/t/contributions-needed/49)
|
2014-03-29 17:36:16 +00:00
|
|
|
lists areas in need of attention.
|
2014-01-28 18:08:45 +00:00
|
|
|
|
2014-03-24 13:57:14 +00:00
|
|
|
## Licensing
|
|
|
|
|
|
|
|
All contributions are made under the same MIT License as the rest of the
|
|
|
|
project, except documentation which is licensed under the Creative
|
|
|
|
Commons Attribution 4.0 International License. You retain the copyright
|
|
|
|
to code you have written.
|
|
|
|
|
|
|
|
When accepting your first contribution, the maintainer of the project
|
2014-07-12 22:45:33 +00:00
|
|
|
will ensure that you are added to the CONTRIBUTORS file. You are welcome
|
|
|
|
to add yourself as a separate commit in your first pull request.
|
2014-03-24 13:57:14 +00:00
|
|
|
|
2014-01-28 18:08:45 +00:00
|
|
|
## Building
|
|
|
|
|
2014-04-30 13:14:42 +00:00
|
|
|
[See the
|
|
|
|
documentation](http://discourse.syncthing.net/t/building-syncthing/44)
|
2014-01-28 18:08:45 +00:00
|
|
|
|
2014-03-24 13:55:13 +00:00
|
|
|
## Branches
|
|
|
|
|
|
|
|
- `master` is the main branch containing good code that will end up in
|
|
|
|
the next release. You should base your work on it. It won't ever be
|
|
|
|
rebased or force-pushed to.
|
|
|
|
|
|
|
|
- `vx.y` branches exist to make patch releases on otherwise obsolete
|
|
|
|
minor releases. Should only contain fixes cherry picked from master.
|
|
|
|
Don't base any work on them.
|
|
|
|
|
|
|
|
- Other branches are probably topic branches and may be subject to
|
|
|
|
rebasing. Don't base any work on them unless you specifically know
|
|
|
|
otherwise.
|
|
|
|
|
|
|
|
## Tags
|
|
|
|
|
|
|
|
All releases are tagged semver style as `vx.y.z`. Release tags are
|
|
|
|
signed by GPG key BCE524C7.
|
|
|
|
|
2014-01-28 18:08:45 +00:00
|
|
|
## Tests
|
|
|
|
|
|
|
|
Yes please!
|
|
|
|
|
|
|
|
## Style
|
|
|
|
|
|
|
|
`go fmt`
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
2014-04-30 13:14:42 +00:00
|
|
|
[Over here!](http://discourse.syncthing.net/category/documentation)
|
2014-01-28 18:08:45 +00:00
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
MIT
|
|
|
|
|