2 ms·
Yeah, I had a PM raise this concern to me and I pointed out that almost all of the advice for "publishing for LLMs" (using descriptive link text, including cont
by starkparker 1y ago
Yeah, I had a PM raise this concern to me and I pointed out that almost all of the advice for "publishing for LLMs" (using descriptive link text, including context and prerequisites for steps, testing and validating code examples, publishing single-page docs formats, generating consistent structure for documentation types using semantic HTML) was already in our documentation standards for people as an audience, and in several cases enforced by tools like Vale, DocDetective, and in-house CI integrations.
Adding an AGENTS.md was as easy as running our single-page static HTML output through Pandoc with a separate context header section stapled to the frontmatter.