Skip to content

Make docs site LLM-friendly#3133

Open
KMajkrzakOctopus wants to merge 3 commits intomainfrom
km/llm-review
Open

Make docs site LLM-friendly#3133
KMajkrzakOctopus wants to merge 3 commits intomainfrom
km/llm-review

Conversation

@KMajkrzakOctopus
Copy link
Copy Markdown
Contributor

The problem: when AI tools like ChatGPT or Claude try to read our docs to answer customer questions, they often fail. Our docs pages were so heavy with navigation menus and chrome that the AI ran out of room before reaching the actual content.

What this branch ships:

  1. Slimmed down the HTML itself by removing duplicated navigation that no human ever saw but bloated every page for AI crawlers.
  2. A "lite" version of every docs page, tailored for AI tools. Same content, none of the chrome. Smaller per page, so AI tools can fit the whole article in one fetch instead of getting cut off.
  3. An index file that lists every page, so any AI tool that knows the standard convention auto-discovers our entire docs library in one request.
  4. A "llms-full" file with every page concatenated together, for use cases like "feed our complete docs into an AI assistant".
  5. A small dropdown on every docs page saying "Use Octopus docs with AI" - allows to copy the page as plain text or open the AI-friendly version with one click.

@team-marketing-branch-protections
Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3133.z22.web.core.windows.net.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.

@KMajkrzakOctopus KMajkrzakOctopus enabled auto-merge May 8, 2026 09:39
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.

2 participants