docs: restructure CONTRIBUTING.md review process

- Reorganize quick checklist for better clarity
- Move category placement check higher in priority
- Restructure automatic rejection section to end for better flow
- Lower star threshold from 500 to 100 for hidden gem consideration
- Add emphasis on one project per PR rule

🤖 Generated with Claude Code (https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Vinta Chen
2026-01-08 13:13:46 +08:00
parent e05cd240c9
commit 436e6cea3f

View File

@@ -1,7 +1,5 @@
# Contributing
Your contributions are always welcome!
## Quick Checklist
Before submitting a PR, verify:
@@ -9,8 +7,8 @@ Before submitting a PR, verify:
- [ ] One link per Pull Request
- [ ] PR title format: `Add project-name`
- [ ] Entry format: `* [project-name](url) - A short description ending with a period.`
- [ ] No mention of "Python" in description (it's implied)
- [ ] Description is concise (one sentence)
- [ ] Placed in the appropriate category/subcategory
- [ ] No trailing whitespace
- [ ] Spelling and grammar checked
@@ -48,17 +46,6 @@ All submissions must satisfy **ALL** of these:
4. **Documented**: Clear README with examples and use cases
5. **Unique**: Adds distinct value, not "yet another X"
## Automatic Rejection
PRs will be **closed without review** if:
- Project is archived or abandoned (no commits in 12+ months)
- Duplicate of existing entry without clear advantages
- No documentation or unclear use case
- Alpha/beta/experimental status
- Self-promotion (wait for someone else to find it useful and submit)
- Less than 500 GitHub stars AND not justified as a hidden gem
## Entry Format Reference
### Standard Entry
@@ -120,8 +107,20 @@ Please include the following in your PR description:
PRs are reviewed by automated tools and maintainers:
1. **Format Check**: Entry follows the correct format
2. **Duplicate Check**: Not already listed or previously rejected
3. **Activity Check**: Project shows recent activity
4. **Quality Check**: Meets acceptance criteria
2. **Category Check**: Placed in the appropriate category/subcategory
3. **Duplicate Check**: Not already listed or previously rejected
4. **Activity Check**: Project shows recent activity
5. **Quality Check**: Meets acceptance criteria
Search previous Pull Requests and Issues before submitting, as yours may be a duplicate.
## Automatic Rejection
PRs will be **closed** if:
- Add more than one project per PR
- Duplicate of existing entry
- Self-promotion (wait for someone else to find it useful and submit)
- Less than 100 GitHub stars AND not justified as a hidden gem
- Project is archived or abandoned (no commits in 12+ months)
- No documentation or unclear use case