Last updated Nov 15, 2024

Centralize developer documentation

The developer documentation feature helps development teams centralize and link their critical documentation to Compass components. This allows developers to quickly find relevant and accurate documentation for the services, applications, and other component types they manage through their catalog.

Once a document has been added to a component, you can sort documents by category, who added the document, and the date they added it.

In Compass, documentation falls into four distinct categories:

  • Discover: Specifications, key concepts, and core features that can help your team understand a component.
  • Contributor: Standards, guides, and diagrams that help your teammates contribute to and integrate with a component.
  • Maintainer: Runbooks and dashboards to help your team maintain a component.
  • Other: All other documentation related to a component.

Documents your team has previously added to a component’s Overview page will now appear on the same component’s Documentation page, categorized as Other. From there, you can decide if the documentation belongs to the Discover, Contributor, or Maintainer categories.

Add documentation to a component

In Compass, if you have a link to your documentation, you can add it to a component.

  1. From the component sidebar, select Documentation.
  2. Select Add documentatio.
  3. Add details to your documentation, including a category and a URL starting with either https:// or http://.
  4. Select Add.

Edit or remove documentation

You can also edit or remove documentation that has been added to a component.

  1. From the component sidebar, select Documentation.
  2. Select the more actions icon (More actions icon).
  3. Select Edit.
  4. Once you’ve updated the document’s details, select Save.

To remove a document:

  1. Select the more actions icon (More actions icon).
  2. Select Remove.

Rate this page: