caddy/CONTRIBUTING.md

47 lines
1.6 KiB
Markdown
Raw Normal View History

2015-04-28 00:41:55 +08:00
## Contributing to Caddy
2015-12-17 23:37:16 +08:00
**[Join our dev chat on Gitter](https://gitter.im/mholt/caddy)** to chat with
other Caddy developers! (Dev chat only; try our
[support room](https://gitter.im/caddyserver/support) for help or
[general](https://gitter.im/caddyserver/general) for anything else.)
2015-05-07 06:39:58 +08:00
This project gladly accepts contributions and we encourage interested users to
get involved!
2015-04-28 00:41:55 +08:00
2015-05-23 01:08:24 +08:00
#### For small tweaks, bug fixes, and tests
Submit [pull requests](https://github.com/mholt/caddy/pulls) at any time.
2015-12-17 23:37:16 +08:00
Bug fixes should be under test to assert correct behavior. Thank you for
helping out in simple ways!
2015-05-23 01:08:24 +08:00
#### Ideas, questions, bug reports
2015-12-18 05:12:22 +08:00
Feel free to [open an issue](https://github.com/mholt/caddy/issues) with your
2015-12-17 23:37:16 +08:00
ideas, questions, and bug reports, if one does not already exist for it. Bug
reports should state expected behavior and contain clear instructions for
isolating and reproducing the problem.
See [How to Report Bugs Effectively](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html).
2015-05-23 01:08:24 +08:00
2015-12-17 23:37:16 +08:00
2015-05-23 01:08:24 +08:00
#### New features
Before submitting a pull request, please open an issue first to discuss it and
claim it. This prevents overlapping efforts and keeps the project in-line with
its goals. If you prefer to discuss the feature privately, you can reach other
2015-12-17 23:37:16 +08:00
developers on Gitter or you may email me directly. (My email address is below.)
2015-05-23 01:08:24 +08:00
And don't forget to write tests for new features!
#### Vulnerabilities
2015-04-28 00:41:55 +08:00
If you've found a vulnerability that is serious, please email me: Matthew dot
Holt at Gmail. If it's not a big deal, a pull request will probably be faster.
2015-04-28 00:41:55 +08:00
2015-05-23 01:08:24 +08:00
## Thank you
Thanks for your help! Caddy would not be what it is today without your contributions.