Live data from Hacker News

Documenting software architecture with arc42

innoq.com

31–34 of 34 posts

Re: Documenting software architecture with arc42

#31

To anyone who has experience with Arc24; How does this compare to the MBSE/SysML framework from OMG? https://www.omgsysml.org/what-is-sysml.htm

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 often used it with UML, and with informal box-and-lines diagrams.

Re: Documenting software architecture with arc42

#32
post #23

I would say arc42 is quite recognized documentation framework among software architects in Germany. My team is working with one major German automotive group and we/they are using slightly modified arc42 to document architectural parts + requirements for one of their core sw platforms. Also as far as I’m aware arc42 is a part of training courses for iSAQ certification for sw architects.

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 arc42, so I'm biased).

Re: Documenting software architecture with arc42

#33
post #19

This isn’t really new. Architecture Definition Documents like this have been around for a long time. All the same, it’s great to see the approach being promoted because there’s a very real need for ADD’s to exist.

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 e-commerce systems)..

(I'm one of the authors of arc42)

Re: Documenting software architecture with arc42

#34

If you're reading German, there's also a book on arc42 by the same author (Gernot Starke), "arc42 in Aktion".

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.

Post reply on HN