> ## Documentation Index
> Fetch the complete documentation index at: https://plasma-ai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Graphs and diagrams

> Explain processes, architecture, dependencies, and relationships.

Pages can render Mermaid diagrams and supported diagram components. Use them to make relationships easier to understand alongside explanatory text.

## Choose a diagram

| Need | Example |
| - | - |
| Process or decision | Flowchart with branches and outcomes |
| Interactions over time | Sequence diagram showing who calls whom |
| System structure | Architecture diagram with named boundaries |
| Ownership or hierarchy | Tree or hierarchy |
| Dependencies | Graph showing which tasks or systems depend on others |

A graph in a Page is authored content. It is not automatically a live map of every resource in the workspace. A wiki's graph is a separate feature built from wiki links.

## Example requests

> Create a Page explaining our release process as a flowchart. Show review, approval, release, and rollback paths. Keep labels short and explain exceptions below the diagram.

> Diagram the browser, API, database, and background worker. Label the requests and distinguish facts in the source from assumptions.

> Map the dependencies between these milestones. Highlight anything that must happen before launch.

For a technical sequence, include the actors and the order of events. For a dependency graph, explain the direction of each arrow.

## Make diagrams readable

Ask for one main idea per diagram, short labels, and a written summary. Split a large architecture into overview and detail views when needed.

Diagrams follow the Page theme. Mermaid configuration overrides and external content are restricted; ask the agent to use the supported renderer rather than embed a remote diagram application.

## Revise and discuss

Ask the Page's author to update the diagram when relationships change. Select nearby explanatory text for a passage comment or use a general Page comment to refer to a named node or edge.

A text comment does not automatically attach to a diagram node. Include the node or connection name in your feedback.

For numeric graphs, see [Charts and dashboards](/fractal-product/pages/charts). For a maintained network of linked documents, see [Wikis](/fractal-product/primitives/wikis).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.