Clarifications to quality standards

This commit is contained in:
Matt Holt 2015-07-04 19:34:59 -06:00
parent b618d5797f
commit d137762b96

View File

@ -20,16 +20,18 @@ Please contribute links to packages/projects you have used or are familiar with.
## Quality standard ## Quality standard
To stay on the list, package repositories should adhere to these quality standards: To be on the list, project repositories should adhere to these quality standards:
- Generally useful to the community - Working
- Functional - Generally useful to the wider community of Go programmers
- Actively maintained (even if that just means acknowledging open issues when they arise) - Actively maintained
- Stable, or progressing toward stable - Regular, recent commits
- Documented (preferably godoc.org) - For finished projects, issues and pull requests are responded to
- Tests are preferred (when possible) - Stableor progressing toward stable
- Thoroughly documented (README, godoc comments, etc.)
- Tests, where practical
## Reporting issues ## Reporting issues
Please open an issue if you would like ot discuss anything that could be improved or have suggestions for making the list a more valuable resource. We realize sometimes packages fall into abandonment or have breaking builds for extended periods of time, so if you see that, feel free to make the change or let us know. We also realize that sometimes projects are just going through transitions or are more experimental in nature. These can still be cool, but we can indicate them as transitory or experimental. Thanks everyone! Please open an issue if you would like ot discuss anything that could be improved or have suggestions for making the list a more valuable resource. We realize sometimes packages fall into abandonment or have breaking builds for extended periods of time, so if you see that, feel free to change its listing or let us know. We also realize that sometimes projects are just going through transitions or are more experimental in nature. These can still be cool, but we can indicate them as transitory or experimental. Thanks everyone!