Skip to content

docs(planning): compact planning/, promote stranded truth to architecture/#45

Merged
lesnik512 merged 1 commit into
mainfrom
docs/compact-planning
Jul 13, 2026
Merged

docs(planning): compact planning/, promote stranded truth to architecture/#45
lesnik512 merged 1 commit into
mainfrom
docs/compact-planning

Conversation

@lesnik512

Copy link
Copy Markdown
Member

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:

  • The profile README's DI table sorts alphabetically (modern-di first, that-depends last). I verified the table follows this today, but grep over architecture/ found no record of it. It was stranded inside a change file whose own frontmatter claimed the work hadn't happened yet.
  • A repo may be listed before its package hits PyPI, at the cost of a temporarily 404ing Downloads badge.

Both now live in architecture/org-profile.md.

What changed

  • architecture/community.md (new) — records what is actually true: GitHub Discussions on modern-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 from changes/. 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.
  • Geometry trims — verbatim copies of shipped source (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 by tokens.py; the coordinates by geometry.py, pinned by test_geometry.py. Design rationale (the ~2px tail overlap, the textLength pinning, why FASTOCTREE) is kept.
  • Ticked the verification boxes on the two merged changes (Metadata-consistency sweep: reconcile 12 profile blurbs #43, docs(profile): drop the type badge column from the templates table #44) — after re-verifying each claim, including a character-for-character comparison of all 19 profile blurbs against their GitHub descriptions.
  • Fixed a broken 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.
  • The vendored convention (README.md, index.py, _templates/) — compacting it would diverge from lesnik512/planning-convention and break the APPLY.md update path.
  • The 21 change files' rationale prose, and the launch playbook's copy.

Verification

  • just check-planningplanning: OK
  • just test149 passed
  • Every pointer written names a symbol that exists (checked by grep against brand/build/); no broken relative links in planning/.

…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.
@lesnik512 lesnik512 merged commit 2d1e5b5 into main Jul 13, 2026
1 check passed
@lesnik512 lesnik512 deleted the docs/compact-planning branch July 13, 2026 20:01
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