Good Docs Describe, Bad Docs Prescribe - by Adam Ard

https://rethinkingsoftware.substack.com/p/good-docs-describe-bad-docs-prescribe