History

doxa-maps-88655c70 e0fc1b14d9 Regenerate the derived library index (3 files, not just mine) check:library-index went red when wagf-region.js landed, and this time the failure was REAL rather than the mtime artifact it was earlier today — regenerating produced a genuine content diff, where the earlier run produced a byte-identical file. The diff carries three additions, only one of them mine: wagf-region.js, plus printInPlace.js and retryableAsyncComponent.js, which arrived on main without the index being regenerated. So the menu was already describing a library that had moved on. Regenerated whole, since it is derived and partial is meaningless. Worth keeping the distinction: "the gate is red" and "the gate is red because of me" are different claims, and the way to tell them apart is to regenerate and diff rather than to reason about mtimes.		2026-09-24 02:24:36 +00:00
..
architecture	Document why a gate cannot import plugin source, and stop teaching public binds	2026-09-22 17:40:11 +00:00
assets	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
contributing	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
readme-images	README: map-cruncher hero, cross-origin deploy certification shots, repo tree	2026-09-24 02:00:00 +00:00
screenshots	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
CONTRIBUTING.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
develop-a-plugin-and-see-it-live.md	Point the golden-path doc at the self-test of the golden path	2026-09-23 10:19:40 +00:00
explanation.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
how-to.md	Land the swarm's work: no iframes anywhere, a tree that keeps its shape, deeper facets	2026-09-22 14:51:52 +00:00
README-embed-example.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
README-longform.md	Say which embed targets we actually verified, and which we only expect to work	2026-09-23 05:33:51 +00:00
README-SECTION-3-cli-commands.md	Run the verification chain in phases instead of one long queue	2026-09-23 20:57:13 +00:00
README.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
reference-capability-exemplars.md	Give nested ProfileLoader children the profile-config they require	2026-09-22 09:37:35 +00:00
reference-library-index.md	Regenerate the derived library index (3 files, not just mine)	2026-09-24 02:24:36 +00:00
reference.md	Fix the same broken token command in reference.md, and say only what was measured	2026-09-23 04:13:45 +00:00
slide-deck-outline.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
tutorial.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
why.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00

README.md

documentation/ — pick your path

        "what is this?"          "teach me"        "how do I …?"       "look it up"      "all the detail"
             │                       │                   │                  │                  │
         why.md  ──────────►  tutorial.md  ────►  how-to.md  ────►  reference.md  ───►  architecture/
        (2 min, 1 diagram)   (first map)         (task recipes)     (tables)           (contracts)

why.md — the problem and the "map islands" idea. Start here.
tutorial.md — build your first map, no jargon.
how-to.md — recipes: embed, iframe, SPA, colors, CDN, mobile, tokens.
reference.md — config fields, build scripts, the profile-config contract.
explanation.md — the model in 15 lines.
architecture/ — the deep end: full contracts, the per-file catalog.
README-embed-example.md — the drop-in README used when this bundler is embedded inside a host repo.

Nothing on the simple path is longer than a few minutes; everything complex lives in architecture/, linked from where you'd need it.