19 lines
1.3 KiB
Markdown
19 lines
1.3 KiB
Markdown
# docs/ — 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](./why.md)** — the problem and the "map islands" idea. Start here.
|
|
- **[tutorial.md](./tutorial.md)** — build your first map, no jargon.
|
|
- **[how-to.md](./how-to.md)** — recipes: embed, iframe, SPA, colors, CDN, mobile, tokens.
|
|
- **[reference.md](./reference.md)** — config fields, build scripts, the `profile-config` contract.
|
|
- **[explanation.md](./explanation.md)** — the model in 15 lines.
|
|
- **[architecture/](./architecture/)** — the deep end: full contracts, the per-file catalog.
|
|
- **[README-embed-example.md](./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.
|