The story’s score and claims

Comments on No. 109 of 155 · I’d Rather Be Writing Blog and API doc course · edition of Wednesday 28 October 2026

Making documentation pages agent friendly

Summary

Tom Johnson's post describes how he is reworking a documentation site so AI agents can read it. Fetch tools typically skip JavaScript, so content that loads only on click is invisible to them, while CSS-hidden content still comes through.

Comments

Ranked by a public rubric, not by votes: what a comment adds counts, not who wrote it. How comments are ranked · Comment rules