Skip to content

v2.0.4 - Semantic HTML, API docs link, onboarding friction

Choose a tag to compare

@ziniman ziniman released this 27 Apr 21:27
· 19 commits to main since this release

What's new in v2.0.4

Three remaining ORA gap fixes in seo-llmo.

Semantic HTML structure (Discovery - 2pts)

New subsection in SPA Considerations explaining that AI vector stores parse document structure to chunk content - not just measure text volume. Covers heading hierarchy, landmark elements (<main>, <nav>, <aside>), semantic lists and tables, and descriptive attributes. Includes curl checks to verify heading count and <main> presence.

API/docs linked from homepage HTML (Identity - 3pts)

ORA checks for a visible <a> link from your homepage HTML to your developer documentation as a separate check from the Link: response header. Added a note to the Link headers section explaining both are required independently, with an HTML example and a fallback suggestion for sites with no public API.

Agent onboarding friction (Auth & Access - 2pts)

Updated the llms.txt Agent instructions example to include two new lines: self-serve signup availability and API access terms. Agents use these declarations to correctly route users - without them, an agent may tell a user to "just sign up" when no self-serve flow exists. The note explains the reasoning so developers understand why these lines matter.