Skip to content

Commit 5fd27fe

Browse files
.
1 parent e835baf commit 5fd27fe

2 files changed

Lines changed: 9 additions & 2 deletions

File tree

as-code.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Structurizr is a “models as code” tool, specifically designed for the C4 mod
1313
- [Learning curve and authoring experience](#learning-curve-and-authoring-experience)
1414
- [Automatic layout and manual layout](#automatic-layout-and-manual-layout)
1515
- [Version control friendly](#version-control-friendly)
16+
- [Traditional Git collaboration workflows](#traditional-git-collaboration-workflows)
1617
- [Developer-friendly](#developer-friendly)
1718
- [AI-friendly](#ai-friendly)
1819

@@ -34,7 +35,9 @@ A false narrative exists that UI-driven tools support manual layout, while "as c
3435

3536
The most obvious benefit to an "as code" approach is that the code you use to generate your diagrams is just text. You, as the author, have complete control over how and where that code is stored (e.g. git). Versions are therefore easy to diff too, making this compatible with pull request development processes. The Structurizr DSL specifically provides a clean separation between the model (content) and views (presentation), which further enhances the ability to diff versions when compared to most other text-based formats that mix content and presentation.
3637

37-
Collaboration and permissioning (e.g. defining who can change which parts of the model) is easy too, since you can lean on the existing infrastructure provided by version control systems. You can also break up a large single model into a number of separate, but connected, smaller models using a system catalog approach, as described in the [enterprise usage pattern](/workspaces/enterprise). UI-driven tools require all of this to be built-in to the tool itself, further bloating the UI.
38+
## Traditional Git collaboration workflows
39+
40+
Team collaboration and permissioning (e.g. defining who can change which parts of the model) is easy too, since you can lean on the existing infrastructure provided by git and other version control systems. You can also break up a large single model into a number of separate, but connected, smaller models using a system catalog approach, as described in the [enterprise usage pattern](/workspaces/enterprise). UI-driven tools require all of this to be built-in to the tool itself, further bloating the UI.
3841

3942
## Developer-friendly
4043

index.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,15 @@ permalink: /
88

99
# Structurizr
1010

11-
Structurizr is a "models as code" tool designed for the [C4 model](https://c4model.com) - you write [Structurizr DSL](/dsl) to create multiple software architecture diagrams from a single model. Structurizr was created by [the author of the C4 model](https://simonbrown.je), is free and open source, and remains the reference implementation, making it the best choice if you are looking for compliance and compatibility with the C4 model.
11+
Structurizr is a "models as code" tool designed for the [C4 model](https://c4model.com) - you write [Structurizr DSL](/dsl) to create multiple software architecture diagrams from a single model.
1212

1313
- [Structurizr DSL - Example](/dsl/example)
1414
- [Structurizr DSL - Tutorial](/dsl/tutorial)
1515

16+
Structurizr's [rich interactive diagrams](/server/diagrams/viewer) with a [customizable notation](/server/diagrams/notation) allow teams to tailor visual styles to their needs. Structurizr brings software architecture to life, making complex systems understandable for everyone from developers and architects to executives and stakeholders. The [as code](/as-code) approach is version control friendly, supporting traditional Git collaboration workflows.
17+
18+
Structurizr was created by [the author of the C4 model](https://simonbrown.je), is free and open source, and remains the reference implementation, making it the best choice if you are looking for compliance and compatibility with the C4 model.
19+
1620
## Quickstart
1721

1822
The two quickest ways to get started with the Structurizr tooling are:

0 commit comments

Comments
 (0)