Comment by watwut
4 hours ago
What I find particularly irritating is that you can actually prompt the fcking AI to be short.
> Writing documentation is arduous and a little painful, which as it turns out is a good thing as it incentivizes the writer to be as succinct as possible.
It takes more effort to be brief, even for humans. Good documentation writers were always brief.
Simply saying "be concise" isn't enough. I often have Claude write first drafts for me (which, for the record, I review completely and rewrite as needed before publishing) and even when told to be concise, there are times when what comes out is unusably long and wordy.