I’ll say “proper docs” has shifted for me for two reasons I used to insist on commenting code richly, so I could better read it. But comments lie, while code i

I’ll say “proper docs” has shifted for me for two reasons I used to insist on commenting code richly, so I could better read it. But comments lie, while code is truth. Read the code, that’s what it does. With AI, the cognitive overhead of getting a human-worded explanation of what’s true, is one prompt away and is never a stale leftover. So the purpose of docs: Specs for implementing and getting an architectural overview, and API documentation for exploring the interface of something new. What I find great is that people still don’t test their code when it became practically free to do so.