oss-contriblisted

# Open Source Contribution Workflow ## Quick Reference | Step | Action | |------|--------| | 1. Sync | `git fetch upstream && git merge upstream/main` | | 2. Research | Read CONTRIBUTING.md, PR templates, CLA requirements | | 3. Branch | Create feature branch from synced default branch | | 4. Code | Match upstream style exactly - no personal preferences | | 5. Test | Run upstream's test suite, match their test patterns | | 6. PR | Follow their PR template, fill all required fields | ## Pre-Contribution Checklist Before writing any code: 1. **Sync fork with upstream** ```bash git fetch upstream git checkout main git merge upstream/main git push origin main ``` 2. **Read contribution guide** - `CONTRIBUTING.md` in repo root - `.github/PULL_REQUEST_TEMPLATE.md` - CLA/DCO signing requirements - Required CI checks and labels 3. **Create feature branch** ```bash git checkout -b fix/issue-description ``` 4. **Scope the change** - Only modify files directly related to the issue - Never refactor or "improve" unrelated code - Never add features beyond what was requested ## Code Style Matching **The most important rule: match the upstream project's style exactly.** Before writing code, check: - Indentation (spaces vs tabs, 2 vs 4) - Quote style (single vs double) - Import ordering and grouping - Naming conventions (snake_case vs camelCase) - Test patterns and fixtures - Docstring format (Google, NumPy, Sphinx) - Error handling p