Skip to content

Commit 1a66634

Browse files
committed
chore(style): remove all em-dashes from user-facing docs
Final sweep to drop every U+2014 em-dash character from the site'"'"'s user-facing surfaces. Replaces em-dash with colon (:) globally. The colon is the natural substitute for an em-dash used as a separator or clarifier, and it preserves the rhythm of titles and section markers without the AI-tell rhythm crutch. Scope (29 files): - README.md, CONTRIBUTING.md, GLOSSARY.md - en/src/*.md (ch01-ch10 + SUMMARY + index) - vi/src/*.md (ch01-ch10 + SUMMARY + index) - zh/src/SUMMARY.md (chapter titles only) - assets/README.md (logo pack list) - en/vi/zh/theme/custom.css (CSS comments) - scripts/add-missing-headings.py, backport-mermaid-ch01.py (docstrings) Skipped: - zh/src/ch*.md — canonical source from dgzhuya.com (author uses Chinese typographic —— as section separator; preserve fidelity) - docs/superpowers/{specs,plans}/* — historical design docs - scripts/translations/*.json, scripts/fetch-zh.ps1 — regenerated by fetch-zh.ps1 from the source Verify: - Build clean (no unclosed-tag warnings introduced; backticks in code spans like `Model<TApi>` preserved) - Frontmatter validation: 30 files OK - Sync check: 10 chapters in sync across 3 langs
1 parent 311e5e0 commit 1a66634

29 files changed

Lines changed: 1264 additions & 1264 deletions

‎assets/README.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Pi Docs — Brand Assets
1+
# Pi Docs : Brand Assets
22

33
This directory holds the official **Pify** brand pack used across the docs site
44
(favicon, sidebar logo, hero, GitHub social preview, README banner).
@@ -25,12 +25,12 @@ machine). All assets here were copied from that source.
2525

2626
## Where each is used
2727

28-
- `favicon.svg` / `favicon.png` — browser tab icon (per mdBook `theme/favicon.{svg,png}`)
29-
- `pify-logo-light-bg.svg` — hero on each language `index.md`, README banner
30-
- `pify-logo-dark-bg.svg` — reserved for dark-only contexts (not currently wired)
31-
- `pify-light-512.png` / `pify-dark-512.png` — sidebar logo via `theme/custom.css`
28+
- `favicon.svg` / `favicon.png` : browser tab icon (per mdBook `theme/favicon.{svg,png}`)
29+
- `pify-logo-light-bg.svg` : hero on each language `index.md`, README banner
30+
- `pify-logo-dark-bg.svg` : reserved for dark-only contexts (not currently wired)
31+
- `pify-light-512.png` / `pify-dark-512.png` : sidebar logo via `theme/custom.css`
3232
(light variant by default, dark variant in `navy` / `coal` / `ayu` / `rust` themes)
33-
- `social-preview.png` (in `.github/`) — GitHub social preview card (1280×640)
33+
- `social-preview.png` (in `.github/`) : GitHub social preview card (1280×640)
3434

3535
## Design tokens
3636

‎en/src/SUMMARY.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@
44

55
# Chapters
66

7-
- [Chapter 1: Introduction — Why Pi-Agent Is Worth Your Time](./ch01-overview.md)
7+
- [Chapter 1: Introduction : Why Pi-Agent Is Worth Your Time](./ch01-overview.md)
88
- [Chapter 2: Three-Layer Architecture](./ch02-three-layer-arch.md)
99
- [Chapter 3: Agent Loop](./ch03-agent-loop.md)
10-
- [Chapter 4: Model Invocation — One Line, Many Providers](./ch04-model-invocation.md)
10+
- [Chapter 4: Model Invocation : One Line, Many Providers](./ch04-model-invocation.md)
1111
- [Chapter 5: Tool System](./ch05-tool-system.md)
1212
- [Chapter 6: Message System](./ch06-messages.md)
1313
- [Chapter 7: Event-Driven Architecture](./ch07-event-driven.md)

‎en/src/ch01-overview.md‎

Lines changed: 78 additions & 78 deletions
Large diffs are not rendered by default.

‎en/src/ch02-three-layer-arch.md‎

Lines changed: 30 additions & 30 deletions
Large diffs are not rendered by default.

‎en/src/ch03-agent-loop.md‎

Lines changed: 58 additions & 58 deletions
Large diffs are not rendered by default.

‎en/src/ch04-model-invocation.md‎

Lines changed: 62 additions & 62 deletions
Large diffs are not rendered by default.

‎en/src/ch05-tool-system.md‎

Lines changed: 73 additions & 73 deletions
Large diffs are not rendered by default.

‎en/src/ch06-messages.md‎

Lines changed: 60 additions & 60 deletions
Large diffs are not rendered by default.

‎en/src/ch07-event-driven.md‎

Lines changed: 40 additions & 40 deletions
Large diffs are not rendered by default.

‎en/src/ch08-context-engineering.md‎

Lines changed: 79 additions & 79 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)