syncthing/CONTRIBUTING.md

57 lines
1.5 KiB
Markdown
Raw Normal View History

2014-03-29 18:36:16 +01:00
Please do contribute! If you want to contribute but are unsure where to
start, the [Contributions Needed
2014-04-30 15:14:42 +02:00
topic](http://discourse.syncthing.net/t/contributions-needed/49)
2014-03-29 18:36:16 +01:00
lists areas in need of attention.
2014-01-28 19:08:45 +01:00
2014-03-24 14:57:14 +01: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-13 00:45:33 +02: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 14:57:14 +01:00
2014-01-28 19:08:45 +01:00
## Building
2014-04-30 15:14:42 +02:00
[See the
documentation](http://discourse.syncthing.net/t/building-syncthing/44)
2014-01-28 19:08:45 +01:00
2014-03-24 14:55:13 +01: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 19:08:45 +01:00
## Tests
Yes please!
## Style
`go fmt`
## Documentation
2014-04-30 15:14:42 +02:00
[Over here!](http://discourse.syncthing.net/category/documentation)
2014-01-28 19:08:45 +01:00
## License
MIT