I have been promoting the use of Structurizr in the company where I work and we are finalizing the purchase of the license. The idea is to create the diagrams via Structurizr and use them for our internal documentation as well as for the documentation we publish for our customers.
Actually I thought there was a gap because there was no way the teams can work separately on the diagrams we have at the company level using the license we wanted to buy (3 workspaces), but I genuinely believe that this tool can really help us for the workflow we want to have. So each single team can use the Lite Docker version to preview the changes and then commit those to our git repository: then the automation will build the diagrams (specifically we will generate the SVG files) and will publish them when we have a new release.
The autoLayout will be a challenge: we need to make sure we are able to extract the layout information from the diagrams on the cloud service (where we set the autoLayout to false and we arranged the items manually) and replicate that in the local environment (otherwise when the developers run the Docker container all the boxes will be piled up in the top left corner). But we will find a way...
Author "Software Architecture for Developers" | Creator of the "C4 model for visualising software architecture" | Founder at Structurizr | Software architecture training at architectis.je
Thanks Raffaele. Regarding layout ... you'll need to export your workspace from the cloud service as a JSON file, and copy this to the Lite data directory (workspace.json) before starting Lite, which will then use that as a basis for diagram layouts. Once you're done editing the DSL, save the workspace, and push the new version of the workspace.json file to the cloud service, to upload everything including the new layout. See structurizr.com/help/lite/workflow for more details.
Author "Software Architecture for Developers" | Creator of the "C4 model for visualising software architecture" | Founder at Structurizr | Software architecture training at architectis.je
I just wanted to add ... there's now an "auto-sync" feature that will sync your workspace between Structurizr Lite and the cloud service. See structurizr.com/help/lite/sync for details.
oh my... Thanks Simon, completely missed that. You should think about a newsletter from time to time, because there are many features and many repositories I'm discovering now (e.g. the Docker Lite image which is a game-changer) that I'm afraid I could miss something.
Author "Software Architecture for Developers" | Creator of the "C4 model for visualising software architecture" | Founder at Structurizr | Software architecture training at architectis.je
What a nice discovery this Structurizr Lite!
I have been promoting the use of Structurizr in the company where I work and we are finalizing the purchase of the license. The idea is to create the diagrams via Structurizr and use them for our internal documentation as well as for the documentation we publish for our customers.
Actually I thought there was a gap because there was no way the teams can work separately on the diagrams we have at the company level using the license we wanted to buy (3 workspaces), but I genuinely believe that this tool can really help us for the workflow we want to have. So each single team can use the Lite Docker version to preview the changes and then commit those to our git repository: then the automation will build the diagrams (specifically we will generate the SVG files) and will publish them when we have a new release.
The autoLayout will be a challenge: we need to make sure we are able to extract the layout information from the diagrams on the cloud service (where we set the autoLayout to false and we arranged the items manually) and replicate that in the local environment (otherwise when the developers run the Docker container all the boxes will be piled up in the top left corner). But we will find a way...
Just for you to know Simon, I'm a big fan.
Thanks Raffaele. Regarding layout ... you'll need to export your workspace from the cloud service as a JSON file, and copy this to the Lite data directory (
workspace.json
) before starting Lite, which will then use that as a basis for diagram layouts. Once you're done editing the DSL, save the workspace, and push the new version of theworkspace.json
file to the cloud service, to upload everything including the new layout. See structurizr.com/help/lite/workflow for more details.I just wanted to add ... there's now an "auto-sync" feature that will sync your workspace between Structurizr Lite and the cloud service. See structurizr.com/help/lite/sync for details.
oh my... Thanks Simon, completely missed that. You should think about a newsletter from time to time, because there are many features and many repositories I'm discovering now (e.g. the Docker Lite image which is a game-changer) that I'm afraid I could miss something.
Following me on Twitter and/or joining the Structurizr Slack group (the link is on the Structurizr help page) will keep you up to date. 👍