The Guide to Software Architecture Documentation

Re:The Guide to Software Architecture Documentation by 29athrowaway on Sunday January 22, 2023 @07:47PM (#34484081)

> "It's so simple most devs can contribute"

Oof... a lot to unpack in this phrase.

You would be surprised to learn how much "devs" actually know.

They may even recalibrate your ego a little bit if you were open to receive feedback.

Those "devs" are the people that have to turn architectural documentation into reality, sometimes ignoring it completely.

[ Parent | on HN ]

Re:The Guide to Software Architecture Documentation by Aeolun on Sunday January 22, 2023 @07:51PM (#34484110)

I think they’re talking about the difference between senior and junior devs here.

[ Parent | on HN ]

Re:The Guide to Software Architecture Documentation by sbarre on Sunday January 22, 2023 @07:58PM (#34484147)

Or just about the fact that in large enterprises a lot of the diagrams are owned by architects, and they're done in some esoteric inscrutable format where only the architect can make changes and updates to it _after_ talking to the developers.

I don't think this was a knock against developers.

[ Parent | on HN ]

Re:The Guide to Software Architecture Documentation by rickette on Sunday January 22, 2023 @10:01PM (#34484956)

Exactly, I'm a dev myself.

[ Parent | on HN ]

Re:The Guide to Software Architecture Documentation by rickette on Sunday January 22, 2023 @10:10PM (#34485030)

"most devs" was meant as "most fellow devs". My whole point is to make architecture documentation a team activity.

[ Parent | on HN ]