Docs Update

docs/reference/README.md

@@ -7,11 +7,13 @@ This directory holds the split **file-by-file inventory** that used to live in t
 | Kind | Where to start |
 | --- | --- |
 | Project overview | [README](../../README.md) |
+| Documentation hub | [docs/README.md](../README.md) |
+| Glossary / FAQ / troubleshooting | [glossary.md](../glossary.md) · [faq.md](../faq.md) · [troubleshooting.md](../troubleshooting.md) |
 | Operator narrative | [Handbook](../../handbook/README.md) |
 | Contributor / `ctx` / Pear | [Developer guide](../../developer-guide/README.md) |
 | Day-to-day use | [Users manual](../../users-manual/README.md) |
 | File-level inventory | This directory (`docs/reference/`) |
-| JSON Schemas | [`docs/schemas/`](../schemas/) |
+| JSON Schemas | [schemas/README.md](../schemas/README.md) |
 | Kernel contract (boundaries) | [`docs/architecture/KERNEL_CONTRACT.md`](../architecture/KERNEL_CONTRACT.md) |
 | Kernel subsystem map | [`docs/architecture/kernel-subsystems.md`](../architecture/kernel-subsystems.md) |
 | POSIX conformance matrix | [`docs/reference/conformance-matrix.md`](conformance-matrix.md) |
@@ -61,7 +63,7 @@ This directory holds the split **file-by-file inventory** that used to live in t
 - **Kernel program (governed expansion)** — [developer-guide/kernel-program.md](../../developer-guide/kernel-program.md)
 - **Out of scope and tooling** (former §§15–16) — [Out of scope and tooling](out-of-scope-and-tooling.md)
 - **curl and wget (delegation, fetch stack, policy)** — [curl and wget](http-curl-and-wget.md)
-- **Published JSON Schemas** — [Published schemas: boot policy, telemetry, boot trace](../schemas/)
+- **Published JSON Schemas** — [schemas/README.md](../schemas/README.md)
 
 ---