Add a simple glossary page to top nav with basic definitions.

Signed-off-by: lauralorenz <[email protected]>

Author: lauralorenz

mkdocs.yml

@@ -43,6 +43,8 @@ nav:
   - Guides:
     - Index: guides/index.md
     - Implementation Guidelines: guides/guidelines.md
+  - Glossary:
+    - Index: references/glossary/index.md
   - Reference:
     - Namespace Sameness: concepts/namespace-sameness.md
     - ClusterSet: api-types/cluster-set.md

site-src/references/glossary/index.md

@@ -0,0 +1,20 @@
+# Glossary
+
+About API: A cluster-local CRD to store arbitrary properties about a cluster. See [About API Overview](concepts/about-api.md). _Previously known as ClusterProperty API._
+
+Cluster Inventory: An old name for the project that became the ClusterProfile API. See _ClusterProfile API_.
+
+ClusterProfile API: A CRD intended to store information about member clusters in a clusterset. See [ClusterProfile API Overview](concepts/clusterprofile-api.md). _Previously known as Cluster Inventory._
+
+ClusterProperty API: An old name for the About API. See also _About API_.
+
+ClusterSet: A group of clusters governed by a signle authority, with a high degree of trust, and in which namespace sameness applies. See [ClusterSet reference](api-types/clusterset.md).
+
+Multicluster Services API: An CRD composed of the ServiceExport and ServiceImport Kinds, used to facilitate accessing Services across clusters. See [Multicluster Services API Overview](concepts/multicluster-services-api.md). _Also known as: MCS API, MCS._
+
+Namespace Sameness: A property of clusters in clustersets, in which Kubernetes objects of the same name in the same namespace are expected to behave similarly across the clusterset. See [Namespace Sameness reference](api-types/namespace-sameness.md).
+
+Work API: A CRD defining the Work Kind, intended to facilitate distributing workloads across multiple clusters. See [Work API Overview](concepts/work-api.md).
+
+
+