Skip to content

docs: name OpsMill in llms.txt site title and description#167

Open
yjouffrault wants to merge 1 commit into
mainfrom
docs-llms-txt-opsmill
Open

docs: name OpsMill in llms.txt site title and description#167
yjouffrault wants to merge 1 commit into
mainfrom
docs-llms-txt-opsmill

Conversation

@yjouffrault

Copy link
Copy Markdown
Contributor

Why

The llms.txt file served at https://docs.infrahub.app/llms.txt is consumed by AI assistants and LLM crawlers to learn what this site is about. It is generated by the @signalwire/docusaurus-plugin-llms-txt plugin from the siteTitle / siteDescription set in docs/docusaurus.config.ts.

Today its header reads:

Comprehensive guide to Infrahub - the modern infrastructure management platform

It never mentions OpsMill, so an LLM reading this file gets no signal that Infrahub is the open-source product built by OpsMill. This is part of a broader effort to help search engines and LLM crawlers associate docs.infrahub.app with opsmill.com (the company site), since the product and company have different names.

Change

In the @signalwire/docusaurus-plugin-llms-txt plugin config:

  • siteTitle: Infrahub DocumentationInfrahub by OpsMill - Documentation
  • siteDescription: now names and links OpsMill —

    Infrahub by OpsMill - the modern infrastructure data management platform. Infrahub is the open-source product built by OpsMill (https://opsmill.com).

These strings become the title and > blockquote at the top of the generated llms.txt (and llms-full.txt).

Related

Companion to the cross-linking changes in opsmill/infrahub#9470 (JSON-LD structured data, og:site_name, footer attribution, overview-page "built by OpsMill" + Solutions list).

A separate, still-open follow-up is on the opsmill.com side: add bidirectional JSON-LD (include docs.infrahub.app + the GitHub org in the Organization sameAs, and add an Infrahub SoftwareApplication node).

🤖 Generated with Claude Code

The generated llms.txt (via @signalwire/docusaurus-plugin-llms-txt)
never mentioned OpsMill, so LLM crawlers reading it had no signal that
Infrahub is built by OpsMill. Name and link OpsMill in the plugin's
siteTitle and siteDescription.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@yjouffrault yjouffrault requested a review from a team as a code owner June 5, 2026 14:52
@yjouffrault yjouffrault requested a review from BeArchiTek June 5, 2026 14:56
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying infrahub-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2d1ec36
Status: ✅  Deploy successful!
Preview URL: https://c610e14b.infrahub-docs.pages.dev
Branch Preview URL: https://docs-llms-txt-opsmill.infrahub-docs.pages.dev

View logs

@BeArchiTek

Copy link
Copy Markdown
Contributor

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