Dragonish@lemmy.dbzer0.comtoExperienced Devs@programming.dev•Is there a "markup language" to describe a debugging session?
2·
8 months agoI am a fan of structurizer and the C4 model in general.
I would use a single .dsl file and add the relationships and entities as you discover them. You can apply tags , and then write filtered views to only show specific tags for sub systems or workflows that a user will follow.
you can pair this with markdown/text notes that reference the png files of the views that structurizer will output.
That has been my experience as well. Signing with SSH keys has been way easier to maintain over time than GPG. Plus you can use the same key to sign that you use for authentication to simplify system setup.