All Collections
Key Principles
Add a description to your workspace
Add a description to your workspace

Describe what is to be documented in your workspace or elsewhere, how to interpret the data model, what elements don't belong and more.

Kristine Marhilevica avatar
Written by Kristine Marhilevica
Updated over a week ago

Add a description to your workspace

When you open a workspace, in the Pages view, at the very top, next to the workspace name there is an editing icon that opens a description field. We see time and time again that users leave this field empty. However, it serves a very specific purpose: In it, you should describe:

  • what is to be documented in that workspace,

  • what should be documented elsewhere (and where relevant, point to where)

  • and how to interpret the data model (how each component type is defined,

  • what elements do not belong in this workspace (where relevant, point to where),

  • what kind of relationship/integration/dependency does each reference type represent etc.).

This information is necessary to ensure that the quality of your documentation remains high.

Given that you have the Administrator or Writing permissions on the relevant workspace,

open the Edit workspace properties right-sidebar by:

  • Right-clicking on the workspace name on the left-side navigator and choose "Edit workspace or

  • From the sidebar menu on the left top corner of the screen. Choose "Edit workspace properties".

Did this answer your question?