this post was submitted on 21 Jun 2023
25 points (96.3% liked)
Experienced Devs
3954 readers
1 users here now
A community for discussion amongst professional software developers.
Posts should be relevant to those well into their careers.
For those looking to break into the industry, are hustling for their first job, or have just started their career and are looking for advice, check out:
- Logo base by Delapouite under CC BY 3.0 with modifications to add a gradient
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
I've used C4 in different ways.
Using Structurizr Lite (docker): I do really like the "as code" aspect. The DSL is okay, the documentation of it not so much. But in the end, the tooling is too limited, and I've never come to terms with it. The diagrams becomes very locked in, and are cumbersome to export.
I'm not a fan of integrating SaaS solutions into the documentation workflow, but would really suggest that in favor of the Lite offering. Although I haven't used it.
Using C4 with ordinary tools: What I've come to use more, is using the conepts (and templates when available) with other, non-specialized tools. With Miro for example (there are templates). While not as cool as the "as code" way, it's an nice and accessible way of visualizing software systems.
I have been using Mermaid for some time. I really like it since there are many systems that support Mermaid syntax. But it's a general tool and doesn't have the benefits of a "framework" Will give Structrz (Lite) a shot, but not being able to embed is an issue.