logoalt Hacker News

sdevonoes • yesterday at 11:14 AM • 2 replies • view on HN

No human reads those md anymore


Replies

balder1991 • yesterday at 2:29 PM

That’s my biggest critique of this. I am working on a project with another dev and I try to keep docs as clean and “straight to the point” as possible. In my previous team, one dev went full “spec driven” and the project started having dozens and dozens of markdown files with hundreds of lines to the point any human being would give up trying to trim it. It just becomes noise, a lot of it not even correct because the specs themselves were mostly AI generated with lots of verbosity and wrong assumptions.

➕ show 1 reply
kursus • yesterday at 12:18 PM

Then what do they actually read?

➕ show 2 replies