docs(planning): compact planning/, promote stranded truth to architecture/#45
Merged
Conversation
…ture/ Remove redundant artifacts from planning/ and move live facts into the truth home, without rewriting the rationale the convention keeps. - architecture/org-profile.md: record the DI table's alphabetical ordering rule (modern-di first, that-depends last) and the pre-PyPI Downloads-badge lag. Both were live but written down nowhere. - architecture/community.md (new): what is actually true today, i.e. Discussions on three repos and deliberately no chat rooms. - 2026-07-02.04-aiohttp-surfaces: retire the stale "ready-to-fire" framing (every precondition is met) and drop the embedded execution plan, which convention 2.0.0 bans from changes/. Kept as the why. - deferred.md: track the genuinely pending work with revisit triggers, i.e. the coordinated launch, the launch-week chat rooms, and the borrowed-audience program. - Replace verbatim copies of shipped source (apparel_back, render_apparel, boosty_cover, _quantize_png, async_loop) and the org mark's coordinate and palette dumps with pointers to the code that owns them, keeping the design rationale. - Tick the verification boxes on the two merged changes, after re-verifying each claim. - Fix a broken changes/ link left by the 2.0 folder-to-file flatten. docs-lockup-hero keeps its CSS: it lives in other repos' brand.css, so this file is the only copy here. just check-planning: OK. just test: 149 passed.
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
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.
Compacts
planning/and moves live facts into the truth home. Net -254 / +146 lines; the rationale the convention tells us to keep is preserved.The finding that mattered
Two rules were live and load-bearing but written down nowhere:
modern-difirst,that-dependslast). I verified the table follows this today, butgrepoverarchitecture/found no record of it. It was stranded inside a change file whose own frontmatter claimed the work hadn't happened yet.Both now live in
architecture/org-profile.md.What changed
architecture/community.md(new) — records what is actually true: GitHub Discussions onmodern-di,that-depends,.github, and deliberately no chat rooms. I checked before writing: Telegram/Discord do not exist and are linked from nowhere, because the doctrine opens them "during launch week" and launch week never fired. Writing "the org runs Discord + Telegram" into the truth home would have made it lie.2026-07-02.04-aiohttp-surfaces(108 → 26 lines) — said "Ready-to-fire", but every precondition is met (repo public, description/topics/homepage set, rows live on both surfaces). Retired the stale framing and deleted the embedded execution plan, which convention 2.0.0 bans fromchanges/. Kept as the why.deferred.md— the genuinely pending work now has revisit triggers: the coordinated launch, the launch-week chat rooms, the borrowed-audience program.apparel_back,render_apparel,boosty_cover,_quantize_png,async_loop) and the org mark's coordinate/palette dumps replaced with pointers to the code that owns them. The palette table was reproduced exactly bytokens.py; the coordinates bygeometry.py, pinned bytest_geometry.py. Design rationale (the ~2px tail overlap, thetextLengthpinning, why FASTOCTREE) is kept.changes/link left behind by the 2.0 folder-to-file flatten.What I deliberately did not touch
docs-lockup-hero's CSS stays. It lives in other repos'docs/css/brand.css, so this change file is the only copy in this repo and the reference for rolling it out to new docs sites. Trimming it would have destroyed the sole record.README.md,index.py,_templates/) — compacting it would diverge fromlesnik512/planning-conventionand break theAPPLY.mdupdate path.Verification
just check-planning→planning: OKjust test→ 149 passedbrand/build/); no broken relative links inplanning/.