[sshine]

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.