News for hackers. Stuff that matters.
Re:The Surprising Power of Documentation by syntheweave on Tuesday June 13, 2023 @04:49AM (#36307453)
I hit an oddly specific realization this weekend while working on an architectural spec: I make better documentation with a color multipen.

The reason why is because it allows a diagram to support more of the cross-cutting concerns by drawing a red arrow or a green arrow through things instead of a blue one.

It's a big moment in my realizations around technical communication. Like, I already knew this stuff mattered, but it's made more concrete when you can look at a diagram and the holistic whole helps you make more sense of things even if the details aren't right yet.

There are no comments on this comment yet.