diff options
| author | Paul Bütow <pbuetow@mimecast.com> | 2019-01-04 11:20:31 +0000 |
|---|---|---|
| committer | Paul Bütow <pbuetow@mimecast.com> | 2020-01-22 20:17:04 +0000 |
| commit | ef0797de245a61e0f92788bc8ff14f84ca82d45e (patch) | |
| tree | 13f912c31540ae0b43258801d271de8830b08a3b /CONTRIBUTING.md | |
| parent | 3205485b522083df47c1ebe6b301576fe12882f1 (diff) | |
Release of I/O Riot 0.5.10.5.1
Diffstat (limited to 'CONTRIBUTING.md')
| -rw-r--r-- | CONTRIBUTING.md | 79 |
1 files changed, 79 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..fa78660 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,79 @@ +Contributing +============ +Contributions of any kind (bug fixes, new features...) are welcome! +This is a development tool and as such it may not be perfect and may be lacking in some areas. + +Certain future functionalities are marked with TODO comments throughout the code. +This however does not mean they will be given priority or ever be done. + + +Reporting bugs +-------------- +- Ensure the bug was not already reported by searching on GitHub under +[Issues][githubissues]. + +- If you're unable to find an open issue addressing the problem, +[open a new one][githubnewissue]. Be sure to include a **title and clear description**, +as much relevant information as possible, and a **code sample** or an **executable test case** +demonstrating the expected behaviour that is not occurring. + + +Writing a patch +--------------- +- Open a new GitHub pull request with the patch. + +- Ensure the PR description clearly describes the problem and solution. +Include the relevant issue number if applicable. + +- Before submitting a merge request please run a comprehensive code quality analysis + +- When you feel that a certain code quality rule is not applicable, make sure to limit your +warning suppression is as strict as possible to not supress other rules that should apply. + +- Please ensure your merge request aligns to existing coding style and naming conventions for consistency. + + +Cosmetic changes +---------------- +- Changes that are cosmetic in nature and do not add anything substantial to the stability, +functionality, or testability will generally not be accepted. + + +New features +------------ + +- Suggest your change(s) to our [mailing list][mailinglist] before writing code. +This will allow us to ensure we do not have a race condition with other contributors. + +- Do not open an issue on GitHub until you have collected positive feedback about the change. +GitHub issues are primarily intended for bug reports and fixes. + + +Questions +--------- + +- Email any question to our [mailing list][mailinglist]. +We will endeavour to answer, but please excuse us if we don't. +The support for this project is dependent on the availability of spare time for our staff. + + +Documentation +------------- + +- I/O Riot's code is documented to a large extent and additional usage documentation is provided +in this project's [doc/](doc/) directory. + +- If you feel that certain areas are lacking and wish to contribute please follow the +**writing a patch** instructions. + + +Thank you +--------- + +Thank you for showing interest in I/O Riot! + +Mimecast Team + +[githubissues]: https://github.com/mimecast/ioriot/issues +[githubnewissue]: https://github.com/mimecast/ioriot/issues/new +[mailinglist]: mailto:opensource@mimecast.com |
