Skip to content

docs(ai): verify and improve docs/llms.txt and docs/llms-full.txt #11

@felixwidjaja

Description

@felixwidjaja

Background

From the AI readiness audit (April 20, 2026). Mintlify auto-generates llms.txt and llms-full.txt for docs sites — these are the primary AI-optimized entry points. Quality depends on how well the docs are structured.

Problem

The auto-generated files may be incomplete or contain artifacts (e.g. the placeholder openapi.json entry, which is being addressed separately in #8). These files are what AI agents should read instead of crawling individual pages.

Actions

  • Verify https://www.datum.net/docs/llms.txt lists all major sections: AI Edge, Connectors, Platform, datumctl, CLI, Domains & DNS, Datum MCP
  • Verify https://www.datum.net/docs/llms-full.txt exists and contains full page content
  • Check whether "Open in Claude" artifacts appear in these files or are stripped by Mintlify's AI output
  • If coverage is incomplete, investigate Mintlify config options for customizing llms.txt content

Notes

Mintlify supports overriding llms.txt content via configuration if the auto-generated output is insufficient. The llms-full.txt endpoint is the right long-term pattern for giving AI systems full content without sidebar noise.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions