Post #1889278
2026-04-08 12:30 UTC
As I agonise over these docs I ask myself, will anyone read this, or will they just ask claude?
I already noticed this at my previous gig, reading comprehension, and the willingness to focus on a non-trivial piece of writing, just going down the drain. Just copy-paste it into chatgpt, skim the AI summary, move on.
Reading technical docs is work, it takes effort and concentration, but you get rewarded with new skills. A good writer can make the reading easier, but there's a lower bound beyond which you sacrifice too much rigor and precision.
Replies (2)
-
@tmr232@mastodon.social 2026-04-08 12:37
@plexus@toot.cat docs, please! Sure, LLMs are useful for quickly finding things, but they get _so much_ wrong, and don't help you build skills. I usually check the docs after getting the recommendations from the LLM (or the code), and make sure things make sense and are done well. Well-documented projects make it easy. Badly documented projects force me to either dig into the source-code, or semi-blindly rely on what the LLM produced.
-
@daveliepmann@social.tchncs.de 2026-04-08 15:47
@plexus@toot.cat I choose to believe that writing for humans will continue to be valued. Keeping the torch lit.