C J Silverio @ceejbot@toot.cat on how to write a software design document.

A design document is not the deliverable you care about. The deliverable you care about is shared understanding of a problem and alignment on a solution.

https://blog.ceejbot.com/posts/design-docs