From d137762b9695d6614ee790ae57a391e87382957a Mon Sep 17 00:00:00 2001 From: Matt Holt Date: Sat, 4 Jul 2015 19:34:59 -0600 Subject: [PATCH 1/3] Clarifications to quality standards --- CONTRIBUTING.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 803de68..4fad5d0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,16 +20,18 @@ Please contribute links to packages/projects you have used or are familiar with. ## 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 -- Functional -- Actively maintained (even if that just means acknowledging open issues when they arise) -- Stable, or progressing toward stable -- Documented (preferably godoc.org) -- Tests are preferred (when possible) +- Working +- Generally useful to the wider community of Go programmers +- Actively maintained + - Regular, recent commits + - For finished projects, issues and pull requests are responded to +- Stableor progressing toward stable +- Thoroughly documented (README, godoc comments, etc.) +- Tests, where practical ## 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! From 8ccb747a34fb02afed6097fa6559e83e47c493d7 Mon Sep 17 00:00:00 2001 From: Matt Holt Date: Sat, 4 Jul 2015 19:38:21 -0600 Subject: [PATCH 2/3] Update CONTRIBUTING.md --- CONTRIBUTING.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4fad5d0..5c13b70 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -22,12 +22,12 @@ Please contribute links to packages/projects you have used or are familiar with. To be on the list, project repositories should adhere to these quality standards: -- Working +- Code is functional - Generally useful to the wider community of Go programmers - Actively maintained - Regular, recent commits - - For finished projects, issues and pull requests are responded to -- Stableor progressing toward stable + - Or, for finished projects, issues and pull requests are responded to +- Stable or progressing toward stable - Thoroughly documented (README, godoc comments, etc.) - Tests, where practical From 25a015b98649dc601a81f229a12adf0f4c6c522b Mon Sep 17 00:00:00 2001 From: Matt Holt Date: Sun, 2 Aug 2015 21:30:20 -0600 Subject: [PATCH 3/3] Add grace window clause --- CONTRIBUTING.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5c13b70..54847d5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -22,7 +22,7 @@ Please contribute links to packages/projects you have used or are familiar with. To be on the list, project repositories should adhere to these quality standards: -- Code is functional +- Code functions as documented and expected - Generally useful to the wider community of Go programmers - Actively maintained - Regular, recent commits @@ -34,4 +34,8 @@ To be on the list, project repositories should adhere to these quality standards ## 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 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! +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. + +Removal changes will not be applied until they have been pending for a minimum of 1 week (7 days). This grace window benefits projects that may be going through a temporary transition but are otherwise worthy of being on the list. + +Thanks everyone!