|
| 1 | +## Description |
| 2 | + |
| 3 | +**Summary**: [Brief one-line description of changes] |
| 4 | + |
| 5 | +**Motivation**: [Why is this change needed? What problem does it solve?] |
| 6 | + |
| 7 | +**Related Issue(s)**: Fixes #XXX |
| 8 | + |
| 9 | +## Type of Change |
| 10 | + |
| 11 | +- [ ] Bug fix (non-breaking change fixing an issue) |
| 12 | +- [ ] New feature (non-breaking change adding functionality) |
| 13 | +- [ ] Breaking change (fix or feature causing existing functionality to not work as expected) |
| 14 | +- [ ] Documentation update |
| 15 | +- [ ] Refactoring (no functional changes) |
| 16 | +- [ ] Performance improvement |
| 17 | +- [ ] Test coverage improvement |
| 18 | + |
| 19 | +## Changes Made |
| 20 | + |
| 21 | +### Core Changes |
| 22 | +- [Change 1] |
| 23 | +- [Change 2] |
| 24 | +- [...] |
| 25 | + |
| 26 | +### API Changes |
| 27 | +- [ ] No API changes |
| 28 | +- [ ] New API added (backward compatible) |
| 29 | +- [ ] API modified (breaking change) |
| 30 | +- [ ] API deprecated |
| 31 | + |
| 32 | +### Documentation Changes |
| 33 | +- [Doc change 1] |
| 34 | +- [Doc change 2] |
| 35 | + |
| 36 | +## Testing |
| 37 | + |
| 38 | +### Test Coverage |
| 39 | +- [ ] Unit tests added/updated |
| 40 | +- [ ] Integration tests added/updated |
| 41 | +- [ ] Test coverage maintained or improved |
| 42 | +- [ ] All tests pass locally |
| 43 | + |
| 44 | +### Testing Checklist |
| 45 | +- [ ] Tested on CPython 3.11 |
| 46 | +- [ ] Tested on CPython 3.12 |
| 47 | +- [ ] Tested on CPython 3.13 |
| 48 | +- [ ] Tested on PyPy 3.11 |
| 49 | +- [ ] Tested with Twisted (if applicable) |
| 50 | +- [ ] Tested with asyncio (if applicable) |
| 51 | +- [ ] Tested on Linux |
| 52 | +- [ ] Tested on macOS |
| 53 | +- [ ] Tested on Windows |
| 54 | + |
| 55 | +### Test Results |
| 56 | +``` |
| 57 | +# Paste test output here |
| 58 | +# Example: pytest output, coverage report, etc. |
| 59 | +``` |
| 60 | + |
| 61 | +## Code Quality |
| 62 | + |
| 63 | +- [ ] Code follows project style guidelines (ruff, black) |
| 64 | +- [ ] Type hints added/updated (mypy passes) |
| 65 | +- [ ] Docstrings added/updated |
| 66 | +- [ ] Comments added for complex logic |
| 67 | +- [ ] No new linter warnings |
| 68 | +- [ ] No security vulnerabilities introduced |
| 69 | + |
| 70 | +## Performance Impact |
| 71 | + |
| 72 | +- [ ] No performance impact |
| 73 | +- [ ] Performance improved |
| 74 | +- [ ] Performance regression (justified in description) |
| 75 | + |
| 76 | +**Benchmarks** (if applicable): |
| 77 | +``` |
| 78 | +# Paste benchmark results |
| 79 | +``` |
| 80 | + |
| 81 | +## Breaking Changes |
| 82 | + |
| 83 | +- [ ] No breaking changes |
| 84 | +- [ ] Breaking changes documented below |
| 85 | + |
| 86 | +**Breaking Changes Description**: |
| 87 | +[Describe what breaks and migration path] |
| 88 | + |
| 89 | +**Migration Guide**: |
| 90 | +```python |
| 91 | +# Before |
| 92 | +old_api() |
| 93 | + |
| 94 | +# After |
| 95 | +new_api() |
| 96 | +``` |
| 97 | + |
| 98 | +## Deployment Notes |
| 99 | + |
| 100 | +- [ ] No special deployment steps required |
| 101 | +- [ ] Database migration needed |
| 102 | +- [ ] Configuration changes needed |
| 103 | +- [ ] Dependencies updated |
| 104 | + |
| 105 | +**Deployment Steps** (if applicable): |
| 106 | +1. [Step 1] |
| 107 | +2. [Step 2] |
| 108 | + |
| 109 | +## Screenshots/Recordings |
| 110 | + |
| 111 | +[If applicable, add screenshots or recordings demonstrating the changes] |
| 112 | + |
| 113 | +## Checklist |
| 114 | + |
| 115 | +- [ ] My code follows the project's style guidelines |
| 116 | +- [ ] I have performed a self-review of my code |
| 117 | +- [ ] I have commented my code, particularly in hard-to-understand areas |
| 118 | +- [ ] I have made corresponding changes to the documentation |
| 119 | +- [ ] My changes generate no new warnings |
| 120 | +- [ ] I have added tests that prove my fix is effective or that my feature works |
| 121 | +- [ ] New and existing unit tests pass locally with my changes |
| 122 | +- [ ] Any dependent changes have been merged and published |
| 123 | + |
| 124 | +## AI Assistance Disclosure |
| 125 | + |
| 126 | +- [ ] This PR was created entirely by a human |
| 127 | +- [ ] This PR was created with AI assistance |
| 128 | + |
| 129 | +**If AI-assisted, please provide details**: |
| 130 | +- **AI Tool**: [e.g., Claude Code, GitHub Copilot] |
| 131 | +- **Scope of AI Assistance**: [e.g., "Code refactoring suggestions", "Test generation", "Documentation writing"] |
| 132 | +- **Human Review**: [Describe how you reviewed and validated the AI-generated content] |
| 133 | + |
| 134 | +**Note**: Per AI_POLICY.md, you (the human) are the sole author of this contribution. |
| 135 | +AI assistance is acknowledged but does not constitute co-authorship. |
| 136 | + |
| 137 | +## Additional Notes |
| 138 | + |
| 139 | +[Any additional context, concerns, or discussion points] |
0 commit comments