Live data from Hacker News

Documenting software architecture with arc42

innoq.com

11–20 of 34 posts

Re: Documenting software architecture with arc42

#11
post #9

Reminds me very much of the Volere Requirements Spec template[1]. There are many ways to Rome, but remember, Rome wasn't build in a day (or with a single architecture plan). [1] https://www.volere.org/templates/volere-requirements-specifi...

i remember listening to a German-language podcast with the arc42 authors and they did mention volere. I forgot about the mutual history, but I think there was some resonance.

Re: Documenting software architecture with arc42

#12
post #11
post #9

Reminds me very much of the Volere Requirements Spec template[1]. There are many ways to Rome, but remember, Rome wasn't build in a day (or with a single architecture plan). [1] https://www.volere.org/templates/volere-requirements-specifi...

i remember listening to a German-language podcast with the arc42 authors and they did mention volere. I forgot about the mutual history, but I think there was some resonance.

Peter Hruschka, one of the authors of arc42, is a colleague of the Robertson family, who authored Volere. All are members of the AtlanticSystemsGuild

Re: Documenting software architecture with arc42

#13
The footnotes in this are messed up. The first one, when clicked the first time, landed in the middle of the article text, instead of at the footnote anchor. It looks like there's some misguided JS value-add lib in use here, which is meant to produce some smooth scrolling effect, but ends up making it worse...

The reference to the second is mangled and appears in the text as "[docs^]".

Re: Documenting software architecture with arc42

#15
post #4

Damn, this is really excellent. Over the course of my career I've written many tech specs, plans, one pagers, six pagers, functional requirements docs, ... etc. Each has been missing something, been too verbose, had sections that really don't integrate well. It's nice to see something a little more cohesive and rationalized. Even if I don't ever use Arc42 explicitly in the future, this is a great reference of what th…

[deleted]

Re: Documenting software architecture with arc42

#17
Many of my documents do indeed have a similar layout for design and it is nice to see efforts like this to create more rigor in SW architecture. As a practitioner (and being opinionated), I have these observations:

- The "Building block view" is really the high level Structural Design. I tend to use structural decomposition to relay this information, iteratively breaking down into subsystems, components, etc. For this reason I prefer the term Structural. - The "Runtime view" is really the Behavioral Design of the system, the sum of behaviors of a system is what you see at runtime.

I wonder if the terminology chosen for arc42 comes from a more academic or earlier time in SW architecture and design.

I'm also a fan of the C4 Model[1] for visualization. So I think I'm going to try to incorporate the two together, like, utilize arc42 for a formal and disciplined approach to architecture documentation coupled with the informative visual paradigm of C4 Landscape, Context, Containers, and Components.

[1] https://c4model.com

Re: Documenting software architecture with arc42

#18

Many of my documents do indeed have a similar layout for design and it is nice to see efforts like this to create more rigor in SW architecture. As a practitioner (and being opinionated), I have these observations: - The "Building block view" is really the high level Structural Design. I tend to use structural decomposition to relay this information, iteratively breaking down into subsystems, components, etc. For thi…

As I was reading this I felt that it overlapped and complemented the C4 approach in a lot of places. There's even a superficial connection: C4 is contained in the title!
Post reply on HN