1
1
Fork 0
mirror of https://code.mensbeam.com/MensBeam/Arsse.git synced 2024-12-23 05:34:55 +00:00
Arsse/CONTRIBUTING.md
Dustin Wilson 5f66f3c8de Added CONTRIBUTING.md
- Started on a contribution aid for contributors; it needs more work.
- Changed the type in composer.json to “project”.
- Made mention of The Arsse in the readme file more consistent.
2017-08-23 18:56:18 -05:00

42 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[a]: https://code.mensbeam.com/MensBeam/Policy/src/master/CODE-OF-CONDUCT.md
[b]: https://code.mensbeam.com/MensBeam/arsse/issues
[c]: http://www.php-fig.org/psr/psr-2/
# Contributing to The Arsse
We would love for you to contribute to our little project and to make The Arsse better. Here are the guidelines we would like you to follow:
* [Code of Conduct](#code-of-conduct)
* [Questions, Bugs, & Feature Requests](#questions-bugs-features)
* [Submission Guidelines](#submission-guidelines)
* [Coding Rules](#coding-rules)
## <a name="code-of-conduct"></a> Code of Conduct
We strive to keep The Arsse open and inclusive. Please read our [Code of Conduct][a] and follow its guidelines when interacting with others within this community.
## <a name="questions-issues-bugs-features"></a> Questions, Bugs & Feature Requests
Questions about how to use The Arsse, bugs, or feature requests can be directed at the [issues page][b].
## <a name="submission-guidelines"></a> Submission Guidelines
### Submitting an issue
Before you submit your issue search the archive to see if your question has been answered for you already. If your issue is new and hasn't been reported open a new issue; please do not report duplicate issues. We would like for you to provide the following information with each issue as it helps us help you:
1. *Overview* Always submit stack traces if the bug produces one.
2. *Versions* What version of The Arsse, php, and operating system are you using?
3. *Reproduce* - Provide a set of steps to reproduce the issue.
4. *Related* - Provide any issues you think might be related.
5. *Suggestions* - If you cannot fix the bug yourself provide any suggestions for fixing the issue.
### Submitting a Pull Request
Before you submit your pull request search for an existing open or closed pull request. Please refrain from duplicating pull requests.
## <a name="coding-rules"></a> Coding Rules
We would like to ensure consistency in our source code, so we follow the [PSR-2 guidelines][c] with one notable exception (utilizing the notation used and outlined in the original document):
**Opening braces for classes and methods MUST go on the same line, and closing braces MUST go on the next line after the body.**