# Documentation

Select Star has three types of documentation:

1. **Pages** - Pages are general purpose and can be used from anything from long technical documentation about processes and data models, to describing key business details at great length, or even an onboarding or feature request doc.
2. **Glossary** - The glossary is the place to document key business terms that are common across your organization. The glossary ensures that everyone is using the same language to facilitate effective communication. e.g. ARR, Subscription, MQL
3. **Metrics** - Metrics are a defined calculation that has business meaning or aligns with a business goal. e.g. ARR could be a metric as well as a glossary term - the glossary term defines the business meaning of the term, and the metric defines how it is calculated and where in the data stack it is represented

### Formatting

All document types generally allow for rich text editing, including **headers, numbered lists,** and **code blocks**. You can **mention** other documents, metrics, users, tables, columns, and BI elements.

Use @ symbol across Select Star in documents, descriptions, and discussions to reference other objects, to create a knowledge network you can navigate. \\

<figure><img src="https://3470314135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgAiVthA_yg9UXKuhyY%2Fuploads%2Fgit-blob-e00ae3ea2c01c46ff3fb5b5cae59c6394b46120e%2FScreenshot%202023-09-19%20at%203.07.55%20PM.png?alt=media" alt=""><figcaption></figcaption></figure>

If the mentioned object is deprecated, we will show the "Invalid mention" message rather than the general mention format. We do not keep deleted data object names in mentions, but the names of any document type object (page, metric, or glossary) will remain even after deletion.\\

<figure><img src="https://3470314135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgAiVthA_yg9UXKuhyY%2Fuploads%2Fgit-blob-c1312bd99de18fafad7b1e04ef9548c43c1a94c8%2FScreenshot%202023-09-19%20at%203.16.34%20PM.png?alt=media" alt=""><figcaption><p>Invalid mention examples</p></figcaption></figure>

### Document Organization

Nest documents in the hierarchy in order to organize them. Drag it and drop it over the document you wish to nest it under.

<figure><img src="https://3470314135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgAiVthA_yg9UXKuhyY%2Fuploads%2Fgit-blob-5d14145c7adc67aedeecc58d1e3dbfa2698843b3%2F2022-11-01%2015.53.03.gif?alt=media" alt=""><figcaption></figcaption></figure>
