Add Documentation

Select Star automatically loads and syncs table and column comments and descriptions, and documentation from BI tools and dbt, but you can also add or update documentation easily.

You can also add to and edit documentation easily in Select Star in a few different ways:

• Add or edit data documentation

• Markdown support

• Upload metadata with CSV

Add or edit data documentation

You can easily add documentation to tables and dashboards with the Edit Description button. Document columns by clicking in the description field.

Click a column description to edit it. When the text is gray, this means the description is suggested and has not yet been revised or accepted by someone on your team. Of course, you can always edit the description and hit enter to save and it will become your user description in Select Star (and the text will change to black).

Add Tags on tables, columns, and dashboards, to annotate the category and status of the data asset.

Markdown Support

To add a description to a document, metric, tag, or metadata object, you can use the text editor that provides styling features via the toolbar or mini toolbar. You can also use markdown to write the descriptions by clicking on the markdown toggle at the bottom of the editor.

We support the following markdown elements: headings, paragraph, link, tabls, bold text, italic. text, code, codeblock, blockquotes, ordered lists and unordered lists.

Limitations: We don't support images and mentions in the description. When converting to markdown, the images will be removed and the mentions will become links. You can also click the "cancel" button to undo the conversion changes to get the images and mentions back from the rich text description.

You can also update descriptions via API.

The markdown support is also available in the column-level descriptions.