Skip to content

Document towncrier changelog workflow; stop uv-lock bot writing changelog_entry.yaml#8061

Merged
MaxGhenis merged 1 commit intomainfrom
docs-towncrier-contributing
Apr 17, 2026
Merged

Document towncrier changelog workflow; stop uv-lock bot writing changelog_entry.yaml#8061
MaxGhenis merged 1 commit intomainfrom
docs-towncrier-contributing

Conversation

@MaxGhenis
Copy link
Copy Markdown
Contributor

Summary

Two stale references to the deprecated changelog_entry.yaml format were still telling humans (and bots) to use it:

  1. CONTRIBUTING.md — the "Work on issues" walkthrough instructed contributors to edit changelog_entry.yaml in step 3, then commit it. PRs following the docs silently fail the PR CI's Check changelog fragment step.
  2. .github/workflows/weekly-uv-lock.yaml — the automated weekly uv-lock update bot wrote a YAML entry with printf '%s\n' '- bump: patch' .... The bot's own PRs were failing the same check.

Both now use the towncrier changelog.d/<branch>.<type>.md fragment format that .github/workflows/pr.yaml's Check changelog fragment step actually validates.

CLAUDE.md already says "DO NOT use changelog_entry.yaml (deprecated)" — this brings the rest of the repo into alignment.

Part of a sweep across PolicyEngine repos (PolicyEngine/policyengine-uk#1629, PolicyEngine/policyengine-core#476) to remove stale references so contributors land on the right path without a CI round-trip.

Test plan

  • CONTRIBUTING.md no longer references changelog_entry.yaml or make changelog
  • weekly-uv-lock.yaml writes a proper towncrier fragment
  • CI passes

…ing changelog_entry.yaml

Two stale references to the deprecated `changelog_entry.yaml` format
were still telling people (and bots) to use it:

1. `CONTRIBUTING.md` — the "Work on issues" walkthrough instructed
   contributors to edit `changelog_entry.yaml` in step 3, then commit
   it. PRs following the docs silently fail the PR CI's "Check
   changelog fragment" step.

2. `.github/workflows/weekly-uv-lock.yaml` — the automated weekly
   uv-lock update bot wrote a YAML entry with `printf '%s\n' '- bump:
   patch' ...`. The bot's own PRs were failing the same check.

Both now use the towncrier `changelog.d/<branch>.<type>.md` fragment
format that `.github/workflows/pr.yaml`'s `Check changelog fragment`
step actually validates.

`CLAUDE.md` already says "DO NOT use changelog_entry.yaml
(deprecated)" — this just brings the rest of the repo into alignment.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@MaxGhenis MaxGhenis force-pushed the docs-towncrier-contributing branch from ba70537 to 8ae9fb0 Compare April 17, 2026 22:46
@MaxGhenis MaxGhenis marked this pull request as ready for review April 17, 2026 23:05
@MaxGhenis MaxGhenis merged commit 1cd144c into main Apr 17, 2026
13 checks passed
@MaxGhenis MaxGhenis deleted the docs-towncrier-contributing branch April 17, 2026 23:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant