zorg42

14 ms·

1.
Making (sw-architecture) documentation fun again(innoq.com)
2 points by zorg42 3y ago|1 comments
2.
by zorg42 3y ago
apply the established idea of "one-page documentation" to software architecture.
3.
by zorg42 4y ago
All of the arc42 documentation is written in English, and the template itself is available in seven different languages. See, e.g., https://docs.arc42.org Apart from one of the founders (me) being German, it's no "Germ
4.
by zorg42 4y ago
a small gallery of (ai-generated) images showing different art styles.
5.
by zorg42 4y ago
A collection of Yoda portraits, purely generated by various AI systems.
6.
by zorg42 4y ago
I would have liked a few diagrams describing some of your ideas, structures or internal processes, instead of using only text.
7.
by zorg42 4y ago
QuickTime can record a window... low computational overhead, and built-in.
8.
by zorg42 4y ago
alternatively, head over to the extensive documentation site(s): https://docs.arc42.org and https://faq.arc42.org both are free to use and hosted on public repos on Github.
9.
by zorg42 4y ago
Right you are, it's definitely not new. arc42 has been used in practice since 2004. The newest version 8.0 has been released Febr. 2022. We incorporated user feedback (plus our own experience in real-time, embedded, data warehouse and
10.
by zorg42 4y ago
arc42 is NOT part of the iSAQB Foundation curriculum. Depending on trainers, it might be covered within iSAQB trainings. If you are interested, you should check with your preferred training organisation in advance. (I'm the author of a
11.
by zorg42 4y ago
SysML (like UML) is a diagramming/modeling notation. Neither of them proposes any high-level structure for documentation. arc42 proposes ONLY a high-level documentation/communicatin structure, and is notation agnostic: I've o
12.
by zorg42 4y ago
(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
13.
by zorg42 4y ago
Peter Hruschka, one of the authors of arc42, is a colleague of the Robertson family, who authored Volere. All are members of the AtlanticSystemsGuild
14.
by zorg42 4y ago
it's free and open-source. it has been translated to EN, ES, DE, NL, IT and UA it's available for AsciiDoc, Markdown, docx, textile, Confluence and numerous other technical formats. many examples, hints and tips on https:/&#
15.
by zorg42 4y ago
thanx, I fixed that.
16.
by zorg42 4y ago
https://www.handelsblatt.com/
17.
by zorg42 4y ago
arc42 is a practical, pragmatic way to communicate and document software architectures. Here's a brief introduction.
18.
Documenting software architecture with arc42(innoq.com)
146 points by zorg42 4y ago|32 comments
19.
by zorg42 4y ago
It's always the same: you get what you pay for. No company offers something for free: If it doesn't cost anything, you're the product: They will use usage-data to optimize their commercial offerings, they will try out feature
20.
by zorg42 4y ago
thanx - pragmatic collection of suggestions