Glossary
Glossary helps readers understand terms in-page in the context of your product. Glossary contains terms and definitions that you define. When these terms appear in a page, they're automatically underlined. Readers can hover over these underlined terms to view their definitions, providing contextual clarity without navigating away.
How to use Glossary
To use glossary:
Defining Glossary
To define terms in the glossary:
- From the sidebar, click on Glossary
. - At the bottom of the list, click on "Add glossary term".
- Write the term (word or phrase, case sensitive).
- Write the definition (one liner).
- Click "Save".
Adding Glossary to Page
To add the glossary term to a page, open up the inline block menu by typing /
, and selecting the term from the list. You may type to search for the term.
Example Glossary
Here you can find a glossary term that we have defined.
Known Limitations of Glossary
- Only applies in documentation pages.
- Does not apply in code blocks.
- Might be out of view on mobile.
Anything missing? Leave us feedback