Skip to content

Latest commit

 

History

History
53 lines (32 loc) · 2.7 KB

documentation.md

File metadata and controls

53 lines (32 loc) · 2.7 KB

Documentation

In addition to diagrams, Structurizr lets you create supplementary documentation using the Markdown or AsciiDoc formats.

Example documentation

See https://structurizr.com/share/31/documentation for an example.

Documentation templates

The documentation is broken up into a number of sections, as defined by the template you are using, the following of which are included:

Custom sections

You can add custom sections using the addSection method on the DocumentationTemplate class:

template.addSection(softwareSystem, "My custom section", Format.Markdown, ...);

Images

Images can be included using the regular Markdown/AsciiDoc syntax.

Including images

For this to work, the image files must be hosted externally (e.g. on your own web server, ideally accessible via HTTPS) or uploaded with your workspace using the addImages() or addImage() methods on the DocumentationTemplate class.

template.addImages(new File("..."));

See functional-overview.md and FinancialRiskSystem for an example.

Embedding diagrams

Software architecture diagrams from your workspace can be embedded within the documentation sections using an additional special syntax.

Embedding diagrams

The syntax is similar to that used for including images, for example:

Markdown - ![](embed:DiagramKey)
AsciiDoc - image::embed:DiagramKey[]

See context.md, context.adoc and FinancialRiskSystem for an example.