Repository navigation
docs(changelog): second-round concision pass over 1.5.0 (#719) - #1088
Conversation
|
Cross-review verdict on The mechanical claims hold:
But the cuts drop design reasons that the #719 rule says to keep. Restore one clause each for:
Spot-checked by me: "seniority", "sees only 35", "namespace the call itself creates" and the |
* Tightens 73 of the 167 entries in `docs/source/changelog/1.5.0.rst` (prose 206,467 -> 177,757 characters, 13.9%; 2807 -> 2449 lines). Cut: test and subtest tallies, sweep and fuzz counts, review history, and restatement. Kept: rejected alternatives, deliberate exceptions, ruled-out causes, breaking-change notes and migration paths. * Entry count unchanged at 167; every `:issue:`/`:pr:`/`:rfc:` citation kept per entry (514 before and after). * Corrects claims the code contradicts: the intro's citation range, the "not yet landed" #859 sentinel, a `Flags.get` default example #868 invalidated, a superseded `TransportProtocol` bound, and three moved docs paths. * Regenerated `CHANGELOG.md` with `util/changelog_md.py`. tests/project: 379 passed, 1 skipped. Sphinx -n warnings identical to main.
0a1b4bb to
09d735c
Compare
|
Cross-review verdict on All nine required restorations from the previous verdict are back and read cleanly: #618, #678, #838, #620, #872, #875, #866, the engine keyword and #692. The three lighter ones are also back: #675, #668 and #647.
Spot-checked by me: the phrases dropped in round one are present again. Pre-existing and out of scope: the #647 line still calls |
Please follow the guide below
make pylint,make mypy,make isort) — N/A, prose onlymake testpasses, and a test case covers the change —tests/project379 passed, 1 skippedWhat is the purpose of your pull request?
docs— documentation onlyDescription of your pull request and other information
Second-round #719 pass over
docs/source/changelog/**. Only1.5.0.rstchanges. The released versions' files needed no typo or markup fixes.:issue:/:pr:/:rfc:citations (514 total).Flags.get('NOPE', 0)example that fix(corekit): stop EnumRegistry.get's default from minting #868 invalidated, a supersededTransportProtocolbound, and three moved docs paths.CHANGELOG.mdregenerated;util/changelog_md.py --checkreports it in step. Sphinx-nwarnings matchmainexactly, with 0 on changelog pages.