[SOLR-16544] Improve documentation on "How to Contribute"

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 9.2
• Component/s: documentation
• Assignee: Jan Høydahl
• Reporter: Justin Sweeney
• Created: 10/Nov/22 19:46
• Updated: 13/Apr/23 15:26
• Resolved: 16/Jan/23 23:31

Description

Currently the main location for information on how to contribute to the Solr open source project is here: https://cwiki.apache.org/confluence/display/solr/HowToContribute. As colleagues I work with are increasing our contributions to the Solr community, we found this documentation difficult to parse and it seems like it could use some love.

My idea is to write up the current best practices for contributing within the dev-docs README in Github: https://github.com/apache/solr/blob/main/dev-docs/README.adoc and link to that from the Solr reference docs to make it more easily findable. This will provide the information for how to contribute in a version controlled location, making updates easier in the future as well. 

Issue Links

• duplicates: SOLR-15682 Add a CONTRIBUTING file
• duplicates: SOLR-16121 Create CONTRIBUTING.md in the git repo's top-level folder
• is related to: SOLR-16746 Migrate How to Contribute content out of Confluence
• links to: GitHub Pull Request #1177
• links to: PR #1177