"Yes, but all #documentation is technical debt. You constantly have to update it. It’s always wrong. Consequently, you should write as a little of it as possible."

👆 The worst take that keeps fueling #agile zealots.

This keeps pushing the "#code is documentation" racket. No, documentation needs to be there because it's the only thing that destroys the silos. Because we had a bad way to document doesn't mean we don't fix the core problem of making documentation effective.

@adymitruk I've had success with https://structurizr.com before, nice tool
Structurizr

Visualise, document and explore your software architecture with Structurizr

@maankoe this is more about workflow design
@adymitruk ok, I'm just making a comment on some useful documentation I've managed to get a team on board with. It's not mutually exclusive.