# Adding documentation

Copy as Markdown[View as Markdown](/docs/studio/diagrams/adding-documentation.md)

***

### How to add documentation to your diagram[​](#how-to-add-documentation-to-your-diagram "Direct link to How to add documentation to your diagram")

EventCatalog Studio allows you to add documentation to your diagram.

Some use cases include:

* Capturing context of your diagram
* Architecture decision records
* Runbooks
* Team processes
* Onboarding information

To add documentation to a design, click on the `Documentation` button in the sidebar.

![Edit node](/assets/images/docs-96b7d9d08aea03395417a6173ae63c3d.png)

This will open a sidebar with the documentation editor.

Writing content in the documentation editor will attach that content to the diagram.

### How to reference nodes in your documentation[​](#how-to-reference-nodes-in-your-documentation "Direct link to How to reference nodes in your documentation")

You can help your teams and users understand your design by adding documentation to your diagram.

You can reference any node in your documentation using the `@` syntax in the editor.

This will let you choose the node you want to reference.

![Reference node](/assets/images/docs-nodes-33f74619b42d63b72dce886b8a9a47e9.png)

Reference nodes in your documentation

Adding references to nodes in your documentation will help your teams and users understand your design. You can use them to walk through your design, or to explain how it works.

When you export your design, the references will be included in the exported documentation.