delve/CONTRIBUTING.md

32 lines
1.4 KiB
Markdown
Raw Normal View History

2015-02-04 18:20:56 +00:00
# Contributing to Delve
Want to help contribute to Delve? Great! Any and all help is certainly appreciated, whether it's code, documentation, or spelling corrections.
2015-03-25 14:15:02 +00:00
If you'd like to join the discussion, hop on #delve-dbgr on irc.freenode.net.
2015-02-04 18:20:56 +00:00
## Filing issues
When filing an issue, make sure to answer these five questions:
1. What version of Delve are you using (`dlv -version`)?
2015-02-04 19:31:13 +00:00
2. What version of Go are you using? (`go version`)?
3. What operating system and processor architecture are you using?
4. What did you do?
5. What did you expect to see?
6. What did you see instead?
2015-02-04 18:20:56 +00:00
## Contributing code
Fork this repo and create your own feature branch. Install all dependencies as documented in the README.
### Guidelines
Consider the following guidelines when preparing to submit a patch:
* Follow standard Go conventions (document any new exported types, funcs, etc.., ensuring proper punctuation).
* Ensure that you test your code. Any patches sent in for new / fixed functionality must include tests in order to be merged into master.
* If you plan on making any major changes, create an issue before sending a patch. This will allow for proper discussion beforehand.
* Keep any os / arch specific code contained to os / arch specific files. Delve leverages Go's filename based conditional compilation, i.e do not put Linux specific functionality in a non Linux specific file.