User-generated descriptions

Documentation makes your data easier to discover, understand, and trust. It helps reduce knowledge gaps, supports onboarding, and enables better collaboration across teams.

One way to document assets is by writing descriptions manually. You can add information to different parts of an asset:

• Use the readme section on table and dashboard pages for rich, structured documentation at the asset-level.

• Use the description field to add short descriptions to individual columns and fields.

When working in the readme section of a table or dashboard, you can also choose to apply a template. Templates provide a consistent structure — for example, sections like overview, data sources, usage, and limitations. You fill out the template manually, helping keep documentation aligned across similar assets.

Manual documentation is especially helpful when you want to capture business context, describe how data is used, or share important notes that aren’t available in source systems.