From 5ac6ae501f21e6700b062d1513d0e59e1a29079e Mon Sep 17 00:00:00 2001
From: Peter Tripp <peter@zed.dev>
Date: Tue, 2 Sep 2025 13:57:48 -0400
Subject: [PATCH] docs: Link glossary (#37387)

Follow-up to: https://github.com/zed-industries/zed/pull/37360

Add glossary.md to SUMMARY.md so it's linked to the public
documentation.

Release Notes:

- N/A
---
 docs/src/SUMMARY.md              |  1 +
 docs/src/development/glossary.md | 10 +++++++++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 9d07881914d1f73a7333d3dc67ad1d3ca6731bc5..a470018b2c9e111f11144149855b833876c511d1 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -157,5 +157,6 @@
   - [FreeBSD](./development/freebsd.md)
   - [Local Collaboration](./development/local-collaboration.md)
   - [Using Debuggers](./development/debuggers.md)
+  - [Glossary](./development/glossary.md)
 - [Release Process](./development/releases.md)
 - [Debugging Crashes](./development/debugging-crashes.md)
diff --git a/docs/src/development/glossary.md b/docs/src/development/glossary.md
index 08bc9f0e91b7e4f054ef9f10892b9be9feffcfce..d0ae12fe03a9955667a69eeb6e270981421b6c02 100644
--- a/docs/src/development/glossary.md
+++ b/docs/src/development/glossary.md
@@ -1,9 +1,17 @@
-These are some terms and structures frequently used throughout the zed codebase. This is a best effort list.
+# Zed Development: Glossary
+
+These are some terms and structures frequently used throughout the zed codebase.
+
+This is a best effort list and a work in progress.
+
+<!--
+TBD: Glossary Improvement
 
 Questions:
 
 - Can we generate this list from doc comments throughout zed?
 - We should have a section that shows the various UI parts and their names. (Can't do that in the channel.)
+-->
 
 ## Naming conventions