text-to-diagram-site
dsl
text-to-diagram-site | dsl | |
---|---|---|
27 | 12 | |
378 | 1,398 | |
4.2% | - | |
6.5 | 0.0 | |
7 months ago | 4 months ago | |
TypeScript | Java | |
GNU General Public License v3.0 only | Apache License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
text-to-diagram-site
-
Ask HN: Guidelines for making clear architecture diagrams
As far as guidelines, I have spent time looking as well an never came away with a good answer. One useful website for comparing some of the best tools is https://text-to-diagram.com/. My personal favorite is D2. Still lacking a few layout features that I want, but it gets me 90% of the way there. The syntax is great for projects big to small, and it strikes the perfect balance between "create a diagram fast" and "feature rich". But in terms of actual guidelines, I would agree with another user that C4 actually tries to lay out some sort of guidelines.
-
Nomnoml
One of those "text to diagram" contenders did a comparison website (open source) a while back: https://text-to-diagram.com/ (nomnoml isn't in there).
-
Documentation as Code for Cloud Using PlantUML
Community list of comparisons between Text to Diagram tools: https://text-to-diagram.com/
-
The Unreasonable Effectiveness of Sequence Diagrams in MermaidJS
https://text-to-diagram.com/?example=sequence&b=mermaid
-
Is there a tool to visualize related stories, tasks, bugs, etc?
If you can get enough data out of the ticket system, maybe something like https://text-to-diagram.com/ will help.
-
D2 (text-to-diagram language): Introducing Grid diagrams
We made a site to let people compare: https://text-to-diagram.com . (Mermaid maintainers contribute to it)
-
Mermaid Cheat Sheet
I think Mermaid is better than PlantUML to write something quickly.
But D2 looks very promising. I like the simpler and more intuitive syntax.
https://text-to-diagram.com/
-
The truth is, being a sysadmin can be a thankless job. What is something that you have done that your are proud of? AKA Toot your own horn Tuesday.
have you seen https://text-to-diagram.com/ for comparing these flowcharts including mermaidJS and graphwiz as you mentioned and there are a few more there.
-
Generate diagrams programmatically with D2
Yes, it's a limited generator, because it's like 20 lines long and not the point of the article.
If you want to compare Mermaid against D2, take a look at https://text-to-diagram.com. The maintainers of Mermaid have contributed to it.
-
D2: Free, open-source modern language for turning text to diagrams
For a comparison with other popular text-to-diagram tools: https://text-to-diagram.com (the maintainers of Mermaid have contributed to this).
dsl
-
D2 is now open source – a new, modern language that turns text to diagrams
1. not currently, but it's on the roadmap!
2. with any integration, if there's enough demand, we'll do it. Once we add interactivity to diagrams, it should be trivial to emulate. However I should mention that Simon Brown (the creator of C4) has his own DSL for C4 https://github.com/structurizr/dsl)! We have no intention of competing with it.
3. Currently the options to tune are limited. The Terrastruct app has granular layout control via drag-and-drop, and we're working to bring some of that to native/open-source.
-
How is your time spent in the architecture role?
It's really just an evolution of the original Structurizr for Java library that I built 5+ years ago. Some people really liked the ability to create a model+views using a programming language (ports are now available for .NET, PHP, Python, TypeScript, etc), but many thought it was silly. So I've always wanted to do something "text-based", but I wanted to do "models as code" rather than "diagrams as code". The lockdown in 2020 gave me some time to do this, and the DSL is really just a thin wrapper on that original Java library. Being a wrapper for the Java library provides a way for you to create parts of your model via scripts (Groovy, Kotlin, JRuby) or by mixing the DSL and code. This creates opportunities for manually defining a high level model, and then perhaps inserting a deployment architecture that's automatically generated by parsing AWS/Azure/Terrform/etc.
-
Structurizr – Diagrams as Code
Some helpful URLs, IMHO
https://structurizr.com/dsl?example=amazon-web-services (hover over the diagram and press the play icon to trigger the "animation" referenced in the DSL)
https://structurizr.com/products as for "which parts are free vs paid"
https://github.com/structurizr/dsl#readme (one of several repos, but unclear which is the "main one") they all seem to be Apache 2 licensed
---
I'm just serving as lazyweb bot, I haven't used this product(service?) before
-
Architecture as Code with C4 and Plantuml
Thanks for structurizr DSL. I'm a big fan of C4 and plantUML. I'll definitely have a look at https://github.com/structurizr/dsl.
-
Diagrams as Code 2.0
Structurizr DSL - https://github.com/structurizr/dsl
-
Software to build a visual representation of the solution?
The C4 model and the Structurizr DSL (demo) are pretty much designed to do exactly this. Disclaimer: I'm the author of both.
-
Reading up on C4 Model...how would you document related systems and repos without repeating yourself?
Create a system landscape, plus a drill-down for each system. In this option you create a new repo in which you define your system landscape - i.e. all of the people and software systems, plus their interactions. In the system1 repo, you extend this model to add the internal details, diagrams, and docs specifically for system1. Repeat for system2 and system3. With this approach, you would see that system1 (and system1.serviceX) interacts with system2, but you wouldn't see system2.serviceY, since that's an implementation detail of, and internal to, system2. The Structurizr DSL has been designed to work for this use case with the "workspace extension" feature, see https://github.com/structurizr/dsl/tree/master/docs/cookbook/workspace-extension for more details.
-
A visual C4 model tool for your team
This (icepanel.io) is just a graphical editor for C4 Model diagrams.
The actual standard (if you can call it that, because it is quite light weight, and that is a good thing) is open source as far as I know.
This means that you can create C4 diagrams with PlantUML [0] or using the C4 specific DSL [1].
[0] - https://github.com/plantuml-stdlib/C4-PlantUML
[1] - https://github.com/structurizr/dsl
-
Alternatives to c4 model?
With this in mind, the Structurizr DSL provides a way to create a model as code, which can then be rendered using tooling of your choice. The Structurizr renderer is one option, but there are others, and you can build your own to meet the style that you're looking for. See structurizr.org - Rendering tools for more.
-
Scripting support added to the Structurizr DSL
The Structurizr DSL now provides a way to run scripts written in Groovy, Kotlin, Ruby, and JavaScript, via the new !script keyword. This gives you access to the underlying Structurizr for Java workspace, for when you need to do something not supported by the DSL.
What are some alternatives?
d2 - D2 is a modern diagram scripting language that turns text to diagrams.
C4-PlantUML - C4-PlantUML combines the benefits of PlantUML and the C4 model for providing a simple way of describing and communicate software architectures
d2-playground - An online runner to play, learn, and create with D2, the modern diagram scripting language that turns text to diagrams.
kubernetes-client - Java client for Kubernetes & OpenShift
mermaid-cli - Command line tool for the Mermaid library
cli - A command line utility for Structurizr.
d2-vscode - VSCode extension for D2 files.
java - Structurizr for Java
obsidian-graphviz - Graphviz plugin for obsidian md.
c4model-visio-stencil - Visio stencil with C4 Model shapes
OpenDiablo2 - An implementation of Diablo 2 in AbyssEngine.
zerocode - A community-developed, free, opensource, automated testing framework for microservices APIs, Kafka(Data Streams) and Load testing. Zerocode Open Source enables you to create, change and maintain your automated test scenarios via simple JSON or YAML files. Visit documentation below: