# Maintain data asset documentation

# Introduction

Accurate asset documentation is essential but not easy to achieve because, in practice, documentation is scattered across source code comments, warehouse system catalogs, and BI tool metadata.

Foundational brings this documentation together in one place and displays up-to-date documentation from across your connected systems. Foundational AI automatically identifies documentation gaps and automatically creates asset documentation using Foundational’s AI.

---

# How it works

**If you've added documentation:** Foundational displays your content. This takes precedence over documentation generated by Foundational’s AI.
​

**If no documentation exists:** Foundational’s AI scans the asset’s lineage, usage information, source code, and documentation of upstream and downstream assets and populates the missing entries. Whenever there are material changes to the data stack, Foundational automatically updates the documentation automatically.
​

You can also assign owners to assets, assign asset tags, and set a certification status, e.g., change an asset status to certified or deprecated.

---

# Documentation use cases

Use the Data Catalog Documentation panel to perform these actions. To see the steps, go to [Actions](#h_c80ca9d24c).
​

![](https://downloads.intercomcdn.com/i/o/pbbyfcys/2154857376/5bdea4f18d48ee8935ccfb31ad47/documentation+use+cases.png?expires=1795287600&amp;signature=f9212c14fbf95ab8d115ace75be2e02c194da9a8b90a089647e0a489e29c79f2&amp;req=diEiEsF7moJYX%2FMW1HO4zcsTG1oRD25jl%2BXnEMbhbPQDYvTlLqZvX%2BCOtjHi%0A1vRz09n9OFPU7YcZMFE%3D%0A)

---

# Data documentation UI

When you select an asset, the Data Catalog displays documentation about that asset in the Content panel. (center).
​

![](https://downloads.intercomcdn.com/i/o/pbbyfcys/2265094186/ebcefb0f103205ae299257fd0c40/documentation+asset+details+documentation+open.png?expires=1795287600&amp;signature=5cf6f6df0038f7df1be2739ceaf33ab5eead6d199b4b76b911adb9805ae52f8e&amp;req=diIhE8l3mYBXX%2FMW1HO4zZhKnaA7HVadqCyWx3HYzne4SWlcj8DbI0s4rV%2B%2B%0A3TgFT0s6RHXc919bFq0%3D%0A)

① Selected data asset
​

② Documentation panel open for the selected asset
​

③ Asset certification
​

④ Asset owner
​

⑤ Documentation information
​

⑥ Inspector panel for the selected data asset
​

⑦ Search for a different data asset

---

# Actions

## Understand data context

**#### Review and verify asset documentation**

1. Select an asset.
​

2. Click **Documentation**:

  - In Data Catalog: **Documentation** appears in the left sidebar

  - From other pages: Click the **Info** icon on the asset, then click **Documentation** in the **Inspector** panel
​

3. Review the documentation sections. Automatic documentation generated by Foundational’s AI displays the label "Generated by Foundational AI."
​

4. To edit any section, click the **Edit** icon.

Changes are saved automatically and preserved even when other metadata updates.

**#### Identify asset owners**

1. Select an asset.
​

2. Click **Documentation**:

  - In Data Catalog: **Documentation** appears in the left sidebar

  - From other pages: Click the **Info** icon on the asset, then click **Documentation** in the **Inspector** panel
​

3. Locate the **Owners** section.
​

4. To add an owner, click the **+** icon.
​

5. In the search field, type the person's name to find them.
​

6. To remove an owner, click the **Bin** icon next to their name.

**#### Identify trusted data assets**

1. Select an asset to view.
​

2. In the left sidebar, click **Documentation**.
​

3. Click the **Certification** dropdown to view the current status or add a certification.
​

4. You can also use filter assets by their certification status in the Data Catalog filter.
​

  ![](https://downloads.intercomcdn.com/i/o/pbbyfcys/2154829383/7566e6d417fec53d7de82b526095/documentation%2Basset%2Bcertification.png?expires=1795287600&amp;signature=51c53f14c99871a2ef8fb08b48291bc376ddac40bf14fa5d6b5d3c2d73ae155d&amp;req=diEiEsF8lIJXWvMW1HO4zbAl%2B6fc4Wm4Rq0cTWJOS6Y%2FUrnAVsNGRkcqnDez%0AEili%0A)