docs(contributing): leave changelog updates to merge time (#8202)

Contributor PRs that touch CHANGELOG.md collide with the fast-moving
Unreleased section on main, and reviewers have been asking submitters to
drop the hunk case by case (e.g. #8183). State the rule in the
Development Workflow: maintainers add the entry at merge time, keeping
the Unreleased section's structure and ordering consistent and the
English and Chinese files in sync.

Co-authored-by: Willem Jiang <willem.jiang@gmail.com>
Co-authored-by: Claude Code <noreply@anthropic.com>
This commit is contained in:
Willem Jiang 2026-11-13 07:26:09 +08:00 committed by GitHub
parent 04a9833763
commit 4d7f770fd6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -320,6 +320,14 @@ Nginx (port 2026) ← Unified entry point
git push origin feature/your-feature-name
```
Please don't include changes to `CHANGELOG.md` or `CHANGELOG_zh.md` in your
pull request. Maintainers add the changelog entry at merge time: this keeps
the Unreleased section's structure and entry ordering consistent and its
English and Chinese files in sync, and it avoids conflicts with other
in-flight merges, where the Unreleased section changes frequently. If your
PR touches the changelog, a reviewer will ask you to drop that hunk — the
rest of the PR is unaffected.
## AI assistance disclosure
DeerFlow is an AI project and we welcome AI-assisted contributions. To help