Good Docs Describe, Bad Docs Prescribe
Of the four tenets of the Agile Manifesto1, one gets the least attention:"Working software over comprehensive documentation."I used to wonder if this line was still necessary. Waterfall is dead, right? We don’t write 40-page specs anymore. We iterate. We deploy constantly. Who even reads documentation? But then along came ADRs — and suddenly, waterfall was back.While documentation isn't forbidden by the Agile Manifesto, it should always take a backseat to the most important document: the source ...
Read more at rethinkingsoftware.substack.com