Documenting a data product

You can find two types of documentation for each of your data products.

• The general documentation that recaps your data product such as the datasets, the data freshness, the data quality, etc.
• The Read me section that contains all the info the data product manager wants to share about the data product.

You can also add key contacts to your data products.

Generating the general documentation of a data product

You can generate, view, and download the documentation of a data product to collect all the information about it in one file such as the data quality, the number of datasets, the quality of each dataset, the fields of each dataset, etc.

You can download the documentation in markdown format (.md).

When a dataset in the data product is in a space to which you do not have access, you can still generate and download the documentation but the dataset and its data will not be included in the documentation.

1. Open the data product from the Catalog or Data products menu.
2. On the right, click > Get documentation. The Documentation window opens.
3. To download in MD format, click Download.

   You can also download in PDF format from your browser. Right-click the documentation > Print....

Editing the read me section

As a data product manager, you can edit the Read me section as much as needed. The rich text format allows you to structure the section to make it as clear as possible.

1. Make sure you have the following roles or permissions:
   • The Data Product Manager role or the Manage data products permission.
   • The permission to edit the space.
2. Open the data product from the Catalog or Data products menu.
3. Select the Documentation tab.
4. Click Edit in the Read me section.
5. Enter the information and click Save.

You can also edit the Read me section by clicking > Documentation on the right.

Adding key contacts

Add key contacts to specify who consumers can contact for any questions or issues with the data product.

1. Make sure you have the following roles or permissions:
   • The Data Product Manager role or the Manage data products permission.
   • The permission to edit the space.
2. Open the data product from the Catalog or Data products menu.
3. Select the Documentation tab.
4. Click Edit in the Contacts section.
5. Enter the key contacts and click Save.

You can also edit the key contacts by clicking > Documentation > Key contacts on the right.