Pinned Assets and Mentions

Pinned Assets

In Catalog you can create references between objects and pages by using the pinned assets section at the bottom of each README section on every asset.

Pinned assets are a great way of linking two assets, for example a business definition like a KPI and data assets related to it, such as a dashboard where the KPI exists or tables from where it is calculated or sourced.

Recommendation

We recommend that every knowledge page should have at least one pinned data asset.

Pinned asset relationships are recursive. The source asset is represented under the "mentioned in" section in the pinned assets area.

Good use of pinned assets can complete a discovery journey. For example, when a user looks for a KPI, they would typically also like to see the dashboards where the KPI is used, or, if you are an analyst, the tables where you can find the KPI for further analysis.

Above is a diagram with examples on the types of relationships that pinned assets can help represent.

In-Page Mentions

One small tip is to use Catalog URLs when you refer to another asset in a README page. The link will be prettified automatically, as in the example below.