Knowledge Map

When you publish your documentation, readers can explore it through the Knowledge Map: an interactive graph visualisation that shows how all your content connects. Instead of navigating through a folder hierarchy, readers can see the relationships between documents and click to navigate directly.

What It Shows

The Knowledge Map displays four types of documents and the links between them.

Relationship Types

Edges represent how documents connect:

Interactive Features

Layout

The Knowledge Map uses the ELK layout algorithm (Sugiyama layered layout) to arrange nodes automatically. The layout adapts based on graph size:

Theming

The Knowledge Map respects your site's theme settings. All 36 colour properties (fills, strokes, text for each node type in both light and dark modes) are configurable through site settings.

Accessibility

The Knowledge Map includes full accessibility support:

• Full keyboard navigation
• ARIA labels on all controls
• Screen reader support with live region announcements
• Focus indicators meeting WCAG guidelines
• Not colour-dependent (shapes + icons provide meaning)
• Respects prefers-reduced-motion and prefers-contrast: high

Model Entities in the Knowledge Map

When a workspace contains a data model (model.neoarc), its entities appear as nodes in the Knowledge Map. Each entity node connects to the schemas, pages, and diagrams that reference it.

Lineage edges form when schema fields map to model properties. These edges trace the path from an API response field, through the schema definition, to the underlying model property. In the Knowledge Map, this appears as a connection between the schema node and the model entity node, making data lineage visible at the document level.

Where It Appears

The Knowledge Map is available on published documentation sites. It provides an alternative navigation method alongside the traditional sidebar, helping readers understand how content relates and discover documentation they might otherwise miss.