On: Guide to Software Architecture Documentation

[29athrowaway]

> "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.

[rickette → 29athrowaway]

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

[Aeolun → 29athrowaway]

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

[sbarre → Aeolun]

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.

[rickette → sbarre]

Exactly, I'm a dev myself.