Profile picture
, 5 tweets, 2 min read
My Authors
Read all threads
I'm prototyping a textual DSL for creating @structurizr models, which currently looks like this...
That DSL fragment describes a number of people and software systems, plus the relationships between them. It doesn't specify any diagrams though. But, using some conventions (for example, "if no diagrams are defined"), we could create them automatically.
In this example, it's possible to automatically create 5 diagrams, based upon the underlying model:

- 1 x System Landscape (showing all people and software systems)
- 4 x System Context diagrams (one for each software system, showing nearest neighbours).
That's 5 diagrams, all generated from the same source file ... and therefore all in-sync and consistent. Once integrated with the structurizr-publish tool (github.com/structurizr/pu…), you'll have an easy way to create a full workspace, including documentation and ADRs.
Thoughts?
Missing some Tweet in this thread? You can try to force a refresh.

Keep Current with Simon Brown

Profile picture

Stay in touch and get notified when new unrolls are available from this author!

Read all threads

This Thread may be Removed Anytime!

Twitter may remove this content at anytime, convert it as a PDF, save and print for later use!

Try unrolling a thread yourself!

how to unroll video

1) Follow Thread Reader App on Twitter so you can easily mention us!

2) Go to a Twitter thread (series of Tweets by the same owner) and mention us with a keyword "unroll" @threadreaderapp unroll

You can practice here first or read more on our help page!

More from @simonbrown see all

Profile picture
Simon Brown
@simonbrown
Indeed! I also don't think that many teams really understand what their codebase looks like...
I've run a number of workshops where I've asked teams to draw software architecture diagrams of their own software. In many cases, you get the typical layered architecture, with all of the arrows pointing downwards (a strictly layered architecture).
Me: that looks lovely; is your codebase really that well structured?
Team: yes
Read 7 tweets
Profile picture
Simon Brown
@simonbrown
One of the reasons is the "model-code gap", as described by @GHFairbanks in his book...
Ever tried to automatically create a diagram from code? It doesn't work well, because the tooling is essentially just reflecting what it sees in the code.
Here's an example - it's an old version of the @springframework PetClinic application. If you load the code into an IDE, and ask it to create a diagram, you'll get something like this.
Read 22 tweets
Profile picture
Simon Brown
@simonbrown
And here are some options for your consideration ... or inspiration. (thread)
First up ... @adrianco created some tooling a while back, which provides an interactive visualisation -> github.com/adrianco/spigo
Then we have @terrastruct, which allows you to add "layers" to your diagrams, making it possible to zoom in to show more detail (click the "Web Server" box) -> app.terrastruct.com/diagrams/10764…
Read 9 tweets

Embed code for your website

×
Follow Us on Twitter!

Did Thread Reader help you today?

Support us! We are indie developers!

This site is made by just two indie developers on a laptop doing marketing, support and development! Read more about the story.

Become a Premium Member ($3.00/month or $30.00/year) and get exclusive features!

Become Premium

Too expensive? Make a small donation by buying us coffee ($5) or help with server cost ($10)

Donate via Paypal Become our Patreon

Thank you for your support!