diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 9d07881914..a470018b2c 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 08bc9f0e91..d0ae12fe03 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