structurizr-site-generatr
Diagon
| structurizr-site-generatr | Diagon | |
|---|---|---|
| 1 | 7 | |
| 186 | 1,432 | |
| 8.6% | - | |
| 9.4 | 5.1 | |
| 4 days ago | about 2 months ago | |
| Kotlin | C++ | |
| Apache License 2.0 | MIT License |
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.
structurizr-site-generatr
-
Architecture diagrams enable better conversations
Recently been doing the same amongst our various teams since we have a mish-mash of Lucidchart, Miro, and other collaborative design tools.
One thing I was experimenting with (read: struggling with!) was a way to keep per-service (per-repo) architecture workspaces which are also synchronized on-commit to a central workspace and used !include to bind them together. The moving parts are not difficult - but writing your DSLs in a way that can handle this can be. This idea would let individual projects be self-sufficient and generate their own README doc diagrams as part of their own build process; but also have a central site which shows all the services as well as inter-service connectivity.
Did you ever consider https://github.com/avisi-cloud/structurizr-site-generatr to bring together your ADRs in with your architecture, or do you keep them separate?
Diagon
-
Architecture diagrams enable better conversations
A few more ASCII-based tool that you could add into your workflow are https://arthursonzogni.com/Diagon/#Sequence which can be used to generate the ASCII that you input into something like Typogram (https://google.github.io/typograms/).
For example, input:
Renderer -> Browser: BeginNavigation() - Typograms: A definition and renderer for ASCII diagrams
-
Hacker News top posts: Dec 21, 2021
Diagon – Interactive ASCII art diagram generators\ (4 comments)
- Diagon – Interactive ASCII art diagram generators
-
Plugin to draw diagrams in Vim
Diagram types supported could be found in upstream repo.
-
Plugin to draw diagrams in Vim using Diagon API
Basically this is a wrapper of Diagon's command line interface to help you draw Unicode or ASCII diagrams in Vim. Please have a look.
-
Vim for presentation?
Doing presentations directly in vim is kinda insane, but if you are insane, I have the tool for you here.
What are some alternatives?
architecture-decision
vnote - A pleasant note-taking platform.
arc42.org-site - (jekyll-based) website for arc42.org - the template for communicating software architectures.
vim-diagon - Vim wrapper of Diagon API to generate simple Unicode or ASCII diagrams
exploring-the-testing-hyperpyramid - Code repo for the KotlinConf 2023 talk by @daviddenton and @s4nchez
sent - a simple plaintext presentation tool
c4-notation - Technical resources for using the C4 model for visualizing software architecture.
litee.nvim - A framework for building Neovim plugins
d2 - D2 is a modern diagram scripting language that turns text to diagrams.
KAI - KAI is a distributed computing model written in modern C++ and is cross-plaftorm. Using custom language translators and an executor, KAI provides full reflection, persistence and cross-process communications without having to modify existing source code. KAI Comes with an automated, generational tricolor garbage collector, and Console- and Window-based interfaces.
asciiflow - ASCIIFlow
vroom-pm - Vim Based Slideshow Presentations