markbac · Oct 16, 2026 · Oct 16, 2026
diff --git a/content/glossary/a-c.md b/content/glossary/a-c.md
diff --git a/content/glossary/d-f.md b/content/glossary/d-f.md
diff --git a/content/glossary/g-k.md b/content/glossary/g-k.md
diff --git a/content/glossary/index.md b/content/glossary/index.md
@@ -5,6 +5,19 @@ author: Mark Bacon
 
 # Glossary
 
-Terms used across software, IoT and architecture, A to Z.
+Terms used across telecoms, networking, embedded and IoT engineering, software architecture and delivery, from A-law to ZigBee.
 
-This section is moving in from technical-documentation's glossary and site-web-content-src's Glossary.
+Each entry starts with a short definition. Acronyms give their expansion first, in bold. A sentence or two of detail follows where it helps, then links to related terms. The entries are deliberately short: they say what a term means and how it fits with the others, and leave the full story to the standards and books.
+
+| Section | Covers, for example |
+| --- | --- |
+| [A to C](a-c.md) | ATM, BGP, Bluetooth, C and C++, CDMA, change control, continuous integration |
+| [D to F](d-f.md) | DNS and its records, DSL, DTLS, duplex, estimation, Ethernet, FOTA |
+| [G to K](g-k.md) | G.711 and other codecs, GSM, HTTP, IMS, IPv4 and IPv6, ISDN, Kanban |
+| [L to N](l-n.md) | L2TP, LTE, LwM2M, MPLS VPNs, MQTT, multicast, NAT |
+| [O to R](o-r.md) | OSPF, PCM, PPP, QoS, REST, risk management, RTOS, RTP |
+| [S to Z and numbers](s-z.md) | Scrum, SIP, SS7, TCP, TLS, UML, VLANs, Wi-Fi, 5G, 802.11 |
+
+[[CAPTION:Table]] The sections of the glossary.
+
+Search finds any term; on the sites, press `/` or `Ctrl+K`.
diff --git a/content/glossary/l-n.md b/content/glossary/l-n.md
diff --git a/content/glossary/o-r.md b/content/glossary/o-r.md
diff --git a/content/glossary/redirects.tsv b/content/glossary/redirects.tsv
diff --git a/content/glossary/s-z.md b/content/glossary/s-z.md
diff --git a/py-doc.yml b/py-doc.yml
@@ -50,9 +50,16 @@ documents:
     outputs: {docx: {}, pdf: {}}
 
   glossary:
-    # Glossary. The section's own pull request lists the rest of its files here.
+    # Glossary: the index, then one file per letter group. Each term is a ### heading, so it has
+    # its own anchor (content/glossary/redirects.tsv maps the old one-page-per-term URLs to them).
     sources:
       - content/glossary/index.md
+      - content/glossary/a-c.md
+      - content/glossary/d-f.md
+      - content/glossary/g-k.md
+      - content/glossary/l-n.md
+      - content/glossary/o-r.md
+      - content/glossary/s-z.md
     outputs: {docx: {}, pdf: {}}
 
   templates: