Repository navigation
[Website] Add AI discoverability: llms.txt, meta tags, docs section - #3534
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds AI-focused discoverability surfaces so coding agents can reliably find Playground’s capabilities, docs, and agent guidance.
Changes:
- Added an
llms.txtmachine-readable site index under the Playground website public assets. - Updated the website HTML metadata to reference
llms.txtand adjust the page description accordingly. - Surfaced AI-assistant guidance on the docs homepage with links to the agent skill guide,
llms.txt, andAGENTS.md.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| packages/playground/website/public/llms.txt | Introduces an AI-readable index describing Playground, key docs, and agent-related resources. |
| packages/playground/website/index.html | Updates meta description and adds an alternate link to llms.txt for discovery. |
| packages/docs/site/docs/main/intro.md | Adds a new section to highlight AI/agent usage and link to key AI-facing resources. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
adamziel
changed the title
adamziel
added
[Type] Enhancement
fellyph
pushed a commit
that referenced
this pull request
Sep 7, 2026
Add the missing AI assistants and license sections, and point Slack to #playground. ## Motivation for the change, related issues English docs/main/intro.md already documents AI usage ([#3534](#3534)), the GPLv2 license, and the #playground Slack channel ([#2345](#2345)). The Tagalog page still omitted those sections and linked #meta-playground. That left /tl/ readers without the AI skill / llms.txt / AGENTS.md links, without the license notice, and with a stale Slack channel name. ## Implementation details - Updated packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/intro.md. - Added a Tagalog description in the frontmatter. - Changed Slack from #meta-playground to #playground. - Moved the Code of Conduct from a tip callout into the Get Involved paragraph, matching English. - Added Paggamit ng Playground kasama ang mga AI assistant, with links to the agent skill guide, llms.txt, and AGENTS.md. - Added Lisensya (GPLv2 or later) and the “Code is Poetry” image. ## Testing Instructions (or ideally a Blueprint) Docs-only change; no Blueprint. <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit - **Documentation** - Added a Filipino-language page description. - Updated contribution guidance with a direct Code of Conduct link and instructions for the designated Slack channel. - Added documentation covering AI assistant integration and licensing. - Added a closing “Code is Poetry” image to the introductory page. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
13 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds instructions for LLMs to more load Playground without hesitation. Claude design tends to refuse it, even though Playground.WordPress.net exists for this type of embedding.
Specific changes:
playground.wordpress.net/llms.txtfollowing the llms.txt spec. Describes what Playground is, how to embed it, key APIs, and explicitly states AI assistants are welcome to use it.<link rel="alternate" type="text/plain" href="https://github.com/llms.txt">to help Claude discover llms.txt<meta name="lms:instructions">says AI agents are welcome. This isn't a real meta name, we're counting on getting that prompt into the model context window to make it more eager to embed Playground/guides/agent-skill-wp-playground), the new llms.txt, and AGENTS.md.