Changelog

Timeline of notable documentation changes in this repository.

2026-09-09 — SEO explanation and Next.js listing tutorial

  • Added What SEO does for a public website, covering discoverability, crawlable HTML, metadata, internal links, sitemap and robots rules, structured data, performance, Search Console, and the limits of automated Google sitelinks.

  • Added Build a search-ready Next.js listing site, a complete App Router path from canonical listing records through production raw-HTML checks.

  • Added a reusable themed diagram of the discovery and improvement loop, and wired both pages into the Diátaxis navigation and landing pages.

  • See Detailed changelog.

2026-09-08 — Canonical themed diagram sources

  • All 19 current non-PlayTime diagrams now keep Mermaid source, explicit Themed SVG manifests, standalone adaptive SVGs, host-controlled SVGs, and preserved fixed originals (29 canonical diagrams total).

  • Mermaid 11 renders text as SVG text, while the versioned theme bindings provide complete light and dark palettes without foreignObject.

  • AsciiDoc image blocks carry the themed-svg role so sites can progressively upgrade the portable image without passthrough HTML.

  • See Detailed changelog.

2026-09-07 — Pathogenesis / composition pointer

2026-09-03 — Fix Reliability SVG encoding (Encoding error)

  • three-altitudes.svg (and sibling rename-breakage-mockup.svg) declared UTF-8 but contained latin-1 MIDDLE DOT 0xB7 bytes. Browsers refuse the XML (Invalid character in the given encoding); the live <img> looked broken even though _images/ returned 200 and the alt was already quoted.

  • Rewrote labels to ASCII separators (` / ); escaped bare `& in the rename mockup. Also repaired ai/curated-watching-linkage.svg the same way.

  • Renamed asset to hree-altitudes-diagram.svg so the live page points at a new _images/ URL (CDN still held the broken bytes at the old path for up to 4h).

  • See Detailed changelog.

2026-09-03 — Quote three-altitudes image alt

  • Internet Reliability index: quote the three-altitudes.svg alt so commas are not parsed as AsciiDoc width/height (live HTML had height="internet" while _images/ returned 200).

2026-09-03 — Reader voice on Reliability and provider mirrors

  • Internet Reliability index and Provider search openings: human umbrella wording; drop dialectic/ownership briefing lines. == 2026-09-03 — Case study link from writing docs

  • Writing clear docs with AI links agent-rules Case study: agent voice vs reader voice. == 2026-09-03 — HCI docs slug an-alternative-to-urls

  • Reliability deep links use …​/an-alternative-to-urls.html (wiki slug matches public title). == 2026-09-03 — An alternative to URLs + editorial titles

  • Internet Reliability sibling faces: symptom Broken links after a URL rename; diagnosis/docs An alternative to URLs.

  • Writing clear docs with AI points at agent-rules Editorial titles (enthymeme + self-test).

2026-09-03 — Oracle titles for conversion quality

2026-09-03 — Toy spike as near-term proof

2026-09-03 — Binary weaving + local lemonade framing

  • Hash-matched binary conversion profiles — add binary weaving (leave-alone vs rewritten boundaries vs replaced modules); local-only lemonade framing; defer DRM/anti-cheat as early-wedge scope.

2026-09-03 — Hash-matched binary conversion profiles

2026-09-03 — MarkView Markdown viewer

2026-09-02 — Provider search and mirror backups

2026-09-02 — SoloMD + Open Provider Registry

  • Recommended SoloMD for local-disk Markdown workflows in Recommended tools.

  • Explanation Markdown editors on local disk (live edit + split screenshots; AI/OPR cross-link).

  • Explanation UniProvider and Open Provider Registry — protocol-first discovery so runners are not taxed by competing unilayer formats; prior art (OpenAI-compat / OpenRouter / LiteLLM / Olla / UPP); online directory deferred to tentative opr-directory.

  • Cross-links from agent control planes, AI studio tooling catalog, nav, and explanation indexes.

2026-09-02 — HCI symptom essay URL retitle

  • Internet Reliability faces: symptom essay link → Path renames that break dependents (/blog/path-renames-that-break-dependents/) in reliability/index.adoc and reference-reliability.adoc.

2026-09-02 — Open-source ecosystem discourse + decentralized video index

2026-09-02 — Tool-run embedding for agents

2026-09-01 — Nav typology icons (SVG, not emoji)

  • Diátaxis nav labels and bucket H1s use plain text; sidebar icons come from @antora-supplemental/nav-typology + nav-typology-diataxis on the docs hub.

  • Start-page grid headings match (expressive emoji kept on Browse/Explore CTAs only).

2026-09-01 — Curated watching (programming)

  • Explanation Curated watching (programming) — programming learning library; first entry: Joe Armstrong, The Mess We’re In (Strange Loop, September 2014) with combined medals + billions-of-lines quote, YouTube, timestamp, and Drive backup links.

2026-09-01 — Diátaxis start-page table parsing

  • Fixed component start page Diátaxis grid: use AsciiDoc table cells (a|) so [.text-center] roles and === headings render instead of printing literally.

2026-09-01 — Aspect-Oriented Programming

2026-08-30 — Diátaxis nav emojis + Tutorials landing

  • Restored 🎓 / 🛠️ / 📚 / 🧠 emojis on all four linked-parent nav labels; H1s on bucket index pages match.

  • Added 🎓 Tutorials index (How-to / Reference / Explanation already had landing pages).

  • Component start page links Tutorials to the new index.

2026-08-30 — Restore Diátaxis siblings in nav

  • Converted .🎓 Tutorials to an unlinked parent (* 🎓 Tutorials + ** children) so How-to / Reference / Explanation stay sibling top-level trees under the component root (a lone Antora .Title had absorbed the later linked parents).

2026-08-30 — Drop component start-page nav duplicate

  • Removed leading * General Knowledge under site-nav-tree (component root already covers the start page).

2026-08-30 — Linked parent section landings

  • Replaced .How-to Guides / .Reference / .Explanation + Overview with linked parents (link text = H1); nested Overview labels under Internet Architecture / Delivery Classes now match those H1s.

  • House rule: agent-rules general/documentation.md.

2026-08-30 — Page title = nav label

  • Aligned document H1s with nav.adoc labels and dropped divergent :navtitle: attrs (one canonical title).

  • House rule: agent-rules general/documentation.md.

2026-08-30 — Open Canvas Interchange (OCIF)

2026-08-29 — Release target patterns

2026-08-29 — Marketing for engineers

2026-08-28 — Curated AI watching (Sophontic)

  • Explanation Curated watching (AI) — mandatory / high-signal list; first entry is Sophontic’s geometric-reasoning interview (Michels).

  • Index convention: grow via topical pages under explanation/ai/; other docs link to topical pages; personal profile keeps its own stable pick list and deep-links for blurbs.

  • Figures: linkage SVG + Mermaid, YouTube still under images/ai/; page-context attrs.

  • See Detailed changelog.

2026-08-25 — Internet Reliability

  • New systems-altitude section Internet Architecture / Internet Reliability (peer to product SPE Architecture on the docs hub).

  • Pages: three altitudes, reference reliability, identity stack, near-term absorb, NDN and friends — thin framing + local Mermaid/PlantUML/SVG; deep-link HCI Labels versus wires and connectome-fs.

  • See Detailed changelog.

2026-08-19 — Graphics rendering engines

2026-08-19 — pnpm run routing reference

  • Reference pnpm run routing — grammar of pnpm run, package.json scripts, --filter vs -C, root-first monorepo commands.

  • pnpm mechanics links to the new page.

2026-08-18 — TCF practice kit on the hub

2026-08-18 — Polyglot distribution (experimental)

2026-08-17 — write-a-skill

  • Renamed Cursor skill write-skill to write-a-skill so the slug is not ambiguous with “write” as a verb.

  • How-to, vibe-coding, catalog, and team SOP now name write-a-skill.

2026-08-17 — Skill descriptions as trigger words

2026-08-15 — Fast org bootstrap (not vibe coding)

  • Business Bootstrap gained Fast org bootstrap (Cursor skill bootstrap-org) for GitHub org identity. This how-to index and vibe-coding explanation point at it so it is not confused with installing Cursor skills.

  • See Detailed changelog.

2026-08-13 — Abstract playbooks

  • Explanation Abstract playbooks — write what you want; PlayTime binds how; Equivalence Engine is a catalog, not a bash-to-PowerShell blender.

  • Figures: layers, hot-replace, bind flow, facets vs lattice, Venn, two-doors koan, argv suitcase, bootstrap, ratchet, attic/basement, overlays, sibling home.

  • Essay: Intents, not shell translation.

  • See Detailed changelog.

2026-08-12 — Quote AsciiDoc image alts that contain commas

  • Unquoted image::file.svg[A, B, C] was emitting HTML width="B" height="C", so figures looked broken even though _images/ files were fine (200).

  • Quoted with alt="…​" across Access mocks, GCP OAuth diagrams, secrets figures, and git-semantic figures.

  • Same day: Access/GCP SVGs that opened with XML Encoding error / EntityName (Windows-1252 bytes, bare &) rewritten as UTF-8 XML with escaped entities.

  • Same day: double-encoded curly quotes in Access/GCP AsciiDoc (classic UTF-8-as-cp1252 mojibake) recovered to ASCII.

  • Same day: Access mock chrome bars redrawn as one fill-only top-rounded path (no stroked rect through the breadcrumb). Hub must redeploy to pick up _images/.

  • See Detailed changelog.

2026-08-12 — Language recommendations

2026-08-12 — Finish GitHub IdP setup (enterprise-setup 500)

2026-08-12 — Access setup order and API credentials

  • How-to: GitHub OAuth App is UI-only (no REST create); Zero Trust team domain is the OAuth Homepage/callback (not the docs host); Access apps deny by default — IdP and Allow policy first. Order of operations.

  • Agents: Pages-scoped API token may GET /access/apps as 200 [] and still 403 on identity providers and policies. Access writes need Global API Key (Composio Cloudflare toolkit) or an Access-scoped token. Agents and API credentials · Composio Cloudflare connection.

  • Explanation What agents cannot automate.

  • New mocks: setup order, team name, token vs key, GitHub OAuth-no-API.

  • See Detailed changelog.

2026-08-12 — How Access learns GitHub org membership

2026-08-12 — Access in front of static sites

2026-08-12 — Composio Cloudflare connect forms

2026-08-12 — Google Cloud project mental model (OAuth)

2026-08-10 — Context7 setup, AI docs writing, nav prune

2026-08-10 — Vibe coding bootstrap (Cursor skills)

  • Explanation Vibe coding bootstrap — AI-studio setup under Vibe coding → Bootstrap (not Business Bootstrap); operator vs drop-into-permissive-agent on-ramps.

  • How-to Bootstrap Cursor skills — personal skills layout, thin rule pointers, worked example writing-news-vs-blog.

  • See Detailed changelog.

2026-08-09 — API key vs token

  • Explanation API key vs token — architectural split (API key / scoped key · PAT / access token); forced Dev-Centr naming; cross-links Secrets Manager and News.

  • See Detailed changelog.

2026-08-09 — Git’s file-shaped change model

2026-08-09 — OS install concurrency

  • Recommended tools and secrets hub point at Business Bootstrap capability areas (Scheduling / Design / Vault) for Cal.com/Cal.diy, Penpot, and Bitwarden/Vaultwarden hosting choices (strategy stays in BB; developer distribution mechanics stay here).

2026-08-08 — Secrets distribution (CLI · MCP · hub)

2026-08-08 — Studio MCP install strategies

2026-08-08 — Composio MCP connectors

2026-08-08 — Product Essentials CentrMark checklists

2026-08-08 — Auxiliary features and delivery classes

2026-08-06 — SDLang / KDL / XDL dual-track decision

  • Structured data formats: keep SDLang in-stack, prefer KDL greenfield, reject Extended SDL/XDL.

  • Mirrors DevCentr sdl.adoc decision table and Content Create catalog (xdl reference-only).

  • See Detailed changelog.

2026-08-06 — npm package managers (Bun + Orogene)

  • Added npm package managers: pnpm preferred, Bun as practical OSS alternative, Orogene as once-and-future closed-aspirational inspiration.

  • Restored pnpm Mechanics (was missing from nav); points at the comparison page.

  • Recommended tools + package registries updated.

2026-08-06 — Documentation markup and structured data formats

2026-08-04 — Git concurrency and FS editions

2026-08-05 — Windows color management pipeline

2026-08-05 — ClearType + Windows docs map

2026-08-04 — Winget registration how-to expanded

2026-08-03 — Software Product Essentials

  • Added Software Product Essentials: shared shipping framework (About/build info, updates, packaging, pipeline, diagnostics) and type-specific guides (libs, GUI, CLI, TUI, games, services).

  • How-tos for About/debug dump, Windows auto-updates, installer packaging; restored git-release, automated-releases, winget, and package-registries pages.

  • Reference checklist: App essentials checklist.

  • See Detailed changelog.

  • Restored Infrastructure as Code (IaC) (was missing after knowledge-base extraction; nav already pointed here).

  • Documented OpenTofu as app default and Pulumi org infra repos via Business Bootstrap cross-links.

2026-07-31 — GitHub Pages custom domain + Cloudflare HTTPS

  • Toolchain Management Pattern now points at OpenShellOrg Entrypoint Dispatch / nu-require.

  • Dev-Centr and OpenShellOrg gains toolchain vs entrypoint ownership row.

  • News: partnering-with-openshellorg on devcentr.org; related-projects footer cluster on the marketing site and docs.

2026-07-27 — Agent control planes catalog

  • Added Agent control planes and compute topologies: inference vs runtime vs execution shell; UI tax; arrangements A-F with Mermaid (all-local, inference-remote-session-local, remote-env / Theo-style, three-tier travel, …​); DevCentr always-on env-aware shell vs IDE agent PTYs.

  • Navigation: Explanation → Infrastructure.

  • See Detailed changelog.

2026-07-26 — Shell environment refresh

  • Added Shell Environment Refresh: stale PATH/env in shells and IDE hosts, VS Code history (including #299940 / PR #299941), why Chocolatey refreshenv fails, desired monitor/notice/auto-run UX, Nushell-first recipes, DevCentr vs OpenShellOrg ownership.

  • Navigation: Explanation → Infrastructure.

  • See Detailed changelog.

2026-07-24 — Brand motion (SVG + Rive)

2026-07-24 — Toolchain Management vocabulary

  • Canonical explanation is now Toolchain Management Pattern (pattern → protocol → control plane → TCF).

  • TCF clarified (IoC adapters; not TMF; broad software ecosystems); points at dev-centr/toolchain-framework CI kit.

  • Flutter how-to and nav updated to point at the Pattern page.

  • See Detailed changelog.

2026-07-24 — Toolchain Control Plane

  • Added Toolchain Control Plane / Flutter setup material (superseded in part by the vocabulary lock-in above).

  • Naming at the time: TCP, TCoP, TCF.

  • See Detailed changelog.

2026-07-24 — WSL distro comparison and setup

  • Added Choosing a WSL Linux Distro: Ubuntu LTS vs Tumbleweed vs Arch vs AlmaLinux, workflows, LTS-vs-rolling clarification, and what Windows WSL Settings covers vs the CLI.

  • Added Set up and manage WSL how-to (install, default distro, Settings app, everyday commands).

  • Navigation: Explanation → Infrastructure; How-to Guides.

  • See Detailed changelog.

2026-07-22 — Nushell recommendation