Description
For architectural documentations, diagrams are an essential part. One easy way to get feature rich, easy to read and modify diagrams is draw.io, which supports an embed feature. See screenshot below:
The link generate with the 'Notion...' item can be pasted as 'embed image URL' directly.
Vanilla feature can be to show the embedded diagram as image, and download it for further editing (or open edit link on draw.io).
Impact
- IT Architects
- System administrators
- Process architects
- Managers
- ...
Additional Context
Notion supports it already and it's a huge game-changer. The main reason is, that the diagrams might change over time due to the evolution of the illustrated content. Supporting (editable or at least exchangeable) diagramming is, therefore, a major requirement when it comes to evaluating documentation tools. In addition, draw.io makes it easy and convenient with the embed feature. Other solutions like Mermaid might be suitable but do not offer high-level and flexible diagramming for different use cases.
Description
For architectural documentations, diagrams are an essential part. One easy way to get feature rich, easy to read and modify diagrams is draw.io, which supports an embed feature. See screenshot below:
The link generate with the 'Notion...' item can be pasted as 'embed image URL' directly.
Vanilla feature can be to show the embedded diagram as image, and download it for further editing (or open edit link on draw.io).
Impact
Additional Context
Notion supports it already and it's a huge game-changer. The main reason is, that the diagrams might change over time due to the evolution of the illustrated content. Supporting (editable or at least exchangeable) diagramming is, therefore, a major requirement when it comes to evaluating documentation tools. In addition, draw.io makes it easy and convenient with the embed feature. Other solutions like Mermaid might be suitable but do not offer high-level and flexible diagramming for different use cases.