Re:Documenting software architecture with arc42
by zorg42 on Sunday August 07, 2022 @02:34AM
(#32374381)
(I'm the author of the article)
I've written about requirements for docu-tools https://www.innoq.com/en/articles/2022/01/principles-of-tech...
In short: You need text + diagramming tools. Go as light as possible, start small (draw.io and Markdown/AsciiDoc). Use high-end modeling tools (like Enterprise Architect or ArchiMate only in larger teams and/or with formal documentation requirements (20+ devs). Have a look at docToolchain.
Re:Documenting software architecture with arc42
by ulrikrasmussen on Friday August 05, 2022 @03:51PM
(#32361115)
I'm using yEd, but that likely has the same issues as you mention, being very open-ended and requiring lots of micromanagement of styles and layouts. Perhaps you are seeking a tool such as plantuml in which you specify your diagrams textually and have them rendered by a compiler. It only supports a specific set of diagram types, primarily from the UML family, but I think it's also possible to install a third party C4 style.
Re:Documenting software architecture with arc42
by thisOtterBeGood on Friday August 05, 2022 @02:46PM
(#32360246)
Im using draw.io Just because it integrates Well to jira and confluence, But there really isnt much difference apart from license costs.
What's the most productive tool you've found?
I keep going back to Visio, but I really want a tool purpose designed for quick architecture diagrams that's more opinionated.
Visio is so open ended, to me, it feels only slightly more efficient than using Photoshop.