Nobody had to ask for the logs
keryx has no users but me, and it still got seven bug reports in two days, all filed by one of my own agent sessions. Checking one meant reading exactly what the reporter had typed, which you don't normally get to do.
Tags
6 pages
Docs
A comment is for a different reader
The tool had comments on under ten per cent of its lines and ninety pages of documentation built into the binary, and I'd argue that was one decision made for two very different readers.
The bot couldn't answer it. Neither could I.
I read the question my support bot had fluffed, gave the correct answer off the top of my head, and was wrong. The docs had fooled the person who wrote them.
The most tempting corpus in any repository
The issue tracker is full of answers, which is exactly why my support bot isn't allowed to quote it. An issue can point at the docs, but it never gets to be the answer.
Three places a document can live
A spec, a how-to and a README walk into a repo. Only one of them should still be there in six months.
My blog was shipping 1.2 MB banners
A post hit Hacker News and the analytics showed pages far heavier than a static site should be. The cover images were the payload.
