Contributing guidelines
Contribution guidelines, also called Contribution guidelines, the CONTRIBUTING.md file, or software contribution guidelines, is a text file which project managers include in free and open-source software packages or other open media packages for the purpose of describing how others may contribute user-generated content to the project.
The file explains how anyone can engage in activities such as formatting code for submission or submitting patches[1]
The existence of the file in a package should increase the chance of a project receiving crowdsourced contributions.[2]
In many cases where projects with contribution files do receive contributions, those contributions do not follow the instructions in the file.[3]
Having a contributions file greatly contributes to the success of projects which depend on user contributions.[4]
References
- ^ Barnes, Kevin R. (17 September 2012). "Contributing Guidelines". The GitHub Blog. GitHub.
- ^ Kobayakawa, Naoki; Yoshida, Kenichi (2017). "How GitHub Contributing.md Contributes to Contributors": 694–696. doi:10.1109/COMPSAC.2017.139.
{{cite journal}}: Cite journal requires|journal=(help) - ^ Elazhary, Omar; Storey, Margaret-Anne; Ernst, Neil; Zaidman, Andy (6 August 2019). "Do as I Do, Not as I Say: Do Contribution Guidelines Match the GitHub Contribution Process?". arXiv:1908.02320 [cs].
- ^ Coelho, Jailton; Valente, Marco Tulio (2017). "Why modern open source projects fail": 186–196. doi:10.1145/3106237.3106246.
{{cite journal}}: Cite journal requires|journal=(help)