Skip to main content

Knowledge

One of Catalog's goal is to centralize all information around your data. Some knowledge goes beyond tables and dashboard, such as KPIs and frequently used terms, and can be stored in the Knowledge section of the Catalog App.

Each entry is composed of a Home, Comments, and History tab. You can nest knowledge page in one another.

Castor dashboard showing sections: Data, Dashboards, Knowledge, People, Workspace, Admin. Knowledge tab lists Active User, Churn Rate, MRR.

Home​

The Home tab is a Rich Text section allowing to describe and explain any concept, KPI, or definition.

A filled in Knowledge page about Active User

Details​

On the right-hand side of your screen

  • Verified: admins can mark an entry as verified to indicate documentation has been reviewed
  • Favorites: users can mark entries as favorites
  • Owners: a user can be assigned as the owner of an entry
  • Description: contains an extract of the description in the Home tab. By clicking on it, you will return to the Home tab.
  • Mentioned in: lists the backlinks of the assets which reference the entry
  • Tags: tags can be used to describe assets. They are common for all users of a company.
  • Delete definition: button to delete definitions. Either an admin or the definition owner can do so

Pinned Assets​

To improve your knowledges content, you can directly pin relevant assets to it

Teams page with tabs for Read me, Comments, and History. Pinned assets include Active Users, user_role, and user with descriptions.

How does this work? Checkout this page that details how it works

Determine which tag relates to the definition you're writing to make all tagged asssets appear in the page directly and dynamically.

  1. Select the tag that is linked to your definition:

    Example Active Users interface showing tabs for Read me, Comments, Map, and History, with tag options and empty description field.

  2. Once the tag is linked, all assets with that tag will appear for easier discovery

    Assets tagged "marketing" include Contact, Account Analysis, and Contact Cumulative Sum MoM with descriptions and checkmarks.

Comments​

To easily collaborate and communicate between users, each dashboard has a Comments section:

Castor interface showing FAQ section with tabs for Read me, Comments, and History, a comment input box, and sidebar navigation.

History​

A log of changes is kept under the History tab:

Castor interface showing FAQ knowledge section with description, history tab, and details panel for editing metadata and tags.