Correct stale documentation and remove dead files - #9148
Merged
Conversation
Docs-accuracy sweep, every claim verified against the repo: - CONTRIBUTING/CLAUDE: Python floor is 3.9 (requires-python >=3.9,<3.15; CI smoke-imports 3.9-3.14), not 3.11; `make test-yaml-no-structural` does not exist (suites are sharded); `make install` runs pip, not uv; `make push-pr-branch` does not exist; fork PRs pass CI (the PR workflow's only secret is CODECOV_TOKEN with fail_ci_if_error: false and no gated-data downloads), so the fork prohibition is stale; programs.yaml mostly uses verified_start_year, not verified_years. - README: codecov badge pointed at the deleted master branch; the code-style badge said black but the repo formats with ruff. - AGENTS.md (root and partners/): the three partner questions are asked in a single AskUserQuestion call per CLAUDE.md, not one at a time. - Removed .github/PULL_REQUEST_TEMPLATE.md (empty since 2023) and .github/changelog_template.md (orphaned by the towncrier migration, zero references), plus LANE_STATUS.md and PR_BODY.md (lane-session working files committed by accident in #8922; LANE_STATUS still said "DO NOT MERGE" about a merged PR). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-accuracy sweep of README.md, CONTRIBUTING.md, CLAUDE.md, AGENTS.md, and .github templates. Every change is grounded in a verified mismatch between the doc and the repo:
requires-python = ">=3.9,<3.15"; classifiers and the CI smoke-import matrix cover 3.9–3.14 (py3.9/3.10 kept for Census per pyproject comment)make test-yaml-no-structuraltest-yaml-no-structural-states,-other-irs, …); docs now list real shardsmake install # install deps (uv)pip install -e .[dev]; CI installs withuv sync --extra devmake push-pr-branch)"CODECOV_TOKENon an upload step withfail_ci_if_error: false(codecov passes tokenless); fork PRs run the full suite green — e.g. #9106–#9142 merged from a fork today. The partner-notice workflow already usespull_request_target.verified_years"verified_start_year; docs now name both fieldsbranch/masterrefs/heads/masterno longer exists upstream; badge now points atmainAskUserQuestioncall; both AGENTS.md files now matchDeleted dead files:
.github/PULL_REQUEST_TEMPLATE.md(0 bytes since 2023, renders nothing),.github/changelog_template.md(orphaned by the towncrier migration; zero references; towncrier configures no template), andLANE_STATUS.md+PR_BODY.md(lane working files committed by accident in #8922 — LANE_STATUS still said "PR #8922 open as DRAFT … DO NOT MERGE" about a long-merged PR). Nothing in the repo references any of the four.Separately discovered and filed as an issue (not touched here because it changes release semantics): 51 changelog fragments sit in forbidden
changelog.d/added|fixed/subdirectories or lack type suffixes, so towncrier and bump_version silently ignore them — those entries never reached any released CHANGELOG.md.🤖 Generated with Claude Code