Skip to content

docs: close remaining Agent Ready warnings - #30

Merged
Videirafo merged 4 commits into
mainfrom
feat/29-agent-ready-polish
Sep 7, 2026
Merged

docs: close remaining Agent Ready warnings#30
Videirafo merged 4 commits into
mainfrom
feat/29-agent-ready-polish

Conversation

@Videirafo

Copy link
Copy Markdown
Owner

Closes #29

Changes

  • adds last_updated to the canonical Markdown frontmatter;
  • adds a public /glossary page and /glossary.md mirror with canonical/alternate discovery;
  • links glossary terminology from the Playground, sitemap and llms.txt;
  • increases useful static HTML text to move the root page above the Agent Ready text-density recommendation;
  • adds tests for glossary discovery and the remaining scanner-critical contracts.

Invariants preserved

  • no change to tool-policy semantics;
  • no change to tenant isolation, approval, or audit behavior;
  • no secrets, LLM provider, or external database introduced;
  • public Render URL remains canonical.

Baseline

Agent Ready before this PR: 93/100, Site 15/15, Page 22/25, llms.txt 100/100, accessibility 100/100.

@Videirafo
Videirafo merged commit 107b417 into main Sep 7, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d527789592

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

- [OpenAPI / Swagger]({PUBLIC_URL}/docs)
- [OpenAPI JSON]({PUBLIC_URL}/openapi.json)
- [Markdown mirror]({PUBLIC_URL}/index.md)
- [Glossary]({PUBLIC_URL}/glossary)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add the glossary to the XML sitemap

When a crawler follows the sitemap advertised by ROBOTS_TXT, this addition is absent because it updates only SITEMAP_MD, while SITEMAP_XML still contains just the root URL. Machine sitemap consumers therefore do not receive the new indexable canonical /glossary page; add a corresponding <url> entry to the XML sitemap and cover it in the sitemap test.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Close remaining Agent Ready warnings

1 participant