Commit 7a710701d46 for woocommerce
commit 7a710701d46f5a4f91182dac25cb5447d567c767
Author: Brian Coords <bacoords@gmail.com>
Date: Tue Nov 17 11:09:38 2026 -0800
Add developer docs homepage and curated llms.txt (#71020)
* Add WooCommerce developer docs homepage and curated AI index
* Fix homepage MDX lint directive
* Align docs setup card with introduction
* Document Studio sample store Blueprints
* Refine developer docs homepage layout and setup tabs
* Simplify homepage cards and resource descriptions
diff --git a/docs/_docu-tools/llms-txt/index.ts b/docs/_docu-tools/llms-txt/index.ts
index f2bfb2beb20..fc2c038eaa6 100644
--- a/docs/_docu-tools/llms-txt/index.ts
+++ b/docs/_docu-tools/llms-txt/index.ts
@@ -36,15 +36,16 @@ export default function llmsTxtPlugin(
console.log(`Found ${markdownFiles.length} markdown files`);
- // Generate llms.txt (file list with descriptions)
- await generateFileList(markdownFiles, buildDir);
+ // Publish the hand-curated index alongside the generated full export.
+ await copyCuratedIndex(buildDir);
- // Generate llms-full.txt (combined content)
+ // Keep llms-full.txt until its consumers and request logs have been checked.
await generateCombinedContent(markdownFiles, buildDir);
console.log(`Generated LLM documentation files in ${buildDir}`);
} catch (err) {
console.error('Error generating LLM documentation:', err);
+ throw err;
}
},
};
@@ -117,21 +118,12 @@ function extractTitle(content: string, filename: string): string {
}
/**
- * Generates llms.txt file with file list and descriptions
+ * Copies the hand-curated llms.txt index into the build output.
*/
-async function generateFileList(files: Array<{ path: string; relativePath: string; content: string; title: string }>, buildDir: string): Promise<void> {
+async function copyCuratedIndex(buildDir: string): Promise<void> {
+ const sourcePath = path.resolve(__dirname, 'llms.txt');
const outputPath = path.join(buildDir, 'llms.txt');
- let content = '# WooCommerce Documentation\n\n';
- content += 'This file contains a list of all documentation files available in the WooCommerce documentation.\n\n';
-
- for (const file of files) {
- const description = extractDescription(file.content);
- const posixPath = file.relativePath.split(path.sep).join('/'); // ensure forward slashes
- const url = `https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/${posixPath}`;
- content += `[${file.title}](${url}) ${description}\n\n`;
- }
-
- await fs.promises.writeFile(outputPath, content, 'utf-8');
+ await fs.promises.copyFile(sourcePath, outputPath);
console.log(`Generated ${outputPath}`);
}
@@ -157,30 +149,6 @@ async function generateCombinedContent(files: Array<{ path: string; relativePath
console.log(`Generated ${outputPath}`);
}
-/**
- * Extracts a brief description from markdown content
- */
-function extractDescription(content: string): string {
- // Remove frontmatter
- let cleanContent = content.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, '');
-
- // Remove headers
- cleanContent = cleanContent.replace(/^#{1,6}\s+.+$/gm, '');
-
- // Get first paragraph (non-empty line)
- const lines = cleanContent.split('\n').filter(line => line.trim() && !line.startsWith(' for Windows installation.
+
+## Start here
+
+- [Developer docs](https://developer.woocommerce.com/docs/getting-started/README.md): Choose a local setup path, learn what you can build, and browse the docs.
+- [Set up a development environment](https://developer.woocommerce.com/docs/getting-started/development-environment.md): Install local tools and choose a WordPress development environment.
+- [AI development guide](https://developer.woocommerce.com/docs/getting-started/ai.md): Find agent tools, the curated index, and individual Markdown docs.
+
+## Local development
+
+- [WordPress Studio CLI](https://wordpress.studio/docs/cli/): Install the CLI and use a Blueprint to create a local site.
+- [Scaffolding and sample data](https://developer.woocommerce.com/docs/getting-started/scaffolding.md): Find tools for starting projects and adding test content.
+- [Debugging](https://developer.woocommerce.com/docs/getting-started/debugging.md): Diagnose issues in a WooCommerce development environment.
+
+## Extensions and themes
+
+- [Extension development](https://developer.woocommerce.com/docs/extensions/getting-started-extensions.md): Start building, testing, and distributing WooCommerce extensions.
+- [Build your first extension](https://developer.woocommerce.com/docs/extensions/getting-started-extensions/building-your-first-extension.md): Follow a practical extension tutorial.
+- [Block theme development](https://developer.woocommerce.com/docs/theming/block-theme-development/theming-woo-blocks.md): Customize WooCommerce templates and styles in a block theme.
+- [Child themes](https://developer.woocommerce.com/docs/theming/theme-development/set-up-a-child-theme.md): Extend an existing theme without editing its files directly.
+- [Block development](https://developer.woocommerce.com/docs/block-development.md): Build and extend WooCommerce blocks.
+
+## APIs
+
+- [WooCommerce REST API](https://developer.woocommerce.com/docs/apis/rest-api/index.md): Read and update store data with authenticated requests.
+- [REST API authentication](https://developer.woocommerce.com/docs/apis/rest-api/authentication.md): Choose an authentication method for WooCommerce REST API requests.
+- [REST API products](https://developer.woocommerce.com/docs/apis/rest-api/v3/products.md): Find product endpoints in the current REST API version.
+- [Store API](https://developer.woocommerce.com/docs/apis/store-api.md): Build shopper-facing product, cart, and checkout experiences.
+- [Store API products](https://developer.woocommerce.com/docs/apis/store-api/resources-endpoints/products.md): Read product data for a storefront.
+- [Store API cart](https://developer.woocommerce.com/docs/apis/store-api/resources-endpoints/cart.md): Read and update the shopper's cart.
+- [Store API checkout](https://developer.woocommerce.com/docs/apis/store-api/resources-endpoints/checkout.md): Learn how checkout requests work.
+- [Extend the Store API](https://developer.woocommerce.com/docs/apis/store-api/extending-store-api.md): Add extension data to Store API responses and requests.
+
+## MCP
+
+- [WooCommerce MCP](https://developer.woocommerce.com/docs/features/mcp.md): Set up the developer preview with the WordPress MCP Adapter and WooCommerce abilities.
+
+## Contribution
+
+- [Contributor guide](https://developer.woocommerce.com/docs/contribution/contributing.md): Find the WooCommerce repository, contribution process, and open issues.
+- [Contribute to the docs](https://developer.woocommerce.com/docs/contribution/contributing-docs/contributing-docs.md): Propose and review documentation changes.
+
+## Reference
+
+- [WooCommerce Code Reference](https://woocommerce.github.io/code-reference/): Look up WooCommerce classes, methods, functions, and hooks.
+- [Code snippets](https://developer.woocommerce.com/docs/code-snippets.md): Find examples for store customizations.
+- [WooCommerce CLI](https://developer.woocommerce.com/docs/wc-cli/cli-overview.md): Find WooCommerce commands for WP-CLI.
+- [Releases](https://developer.woocommerce.com/releases/): Find WooCommerce Core versions and downloads.
+- [Changelog](https://developer.woocommerce.com/changelog/): Read release notes and project updates.
diff --git a/docs/_docu-tools/src/css/custom.css b/docs/_docu-tools/src/css/custom.css
index 0e62eeb8fec..127646ed13e 100644
--- a/docs/_docu-tools/src/css/custom.css
+++ b/docs/_docu-tools/src/css/custom.css
@@ -154,3 +154,276 @@ html[data-theme='dark'] .markdown ol > li::before {
background-color: #343942;
color: #e6edf3;
}
+
+/* WooCommerce developer docs landing page */
+html[class*='docs-doc-id-getting-started/README'] main .container {
+ max-width: 1440px;
+}
+
+html[class*='docs-doc-id-getting-started/README'] .theme-doc-breadcrumbs {
+ display: none;
+}
+
+html[class*='docs-doc-id-getting-started/README'] .markdown-copy-button {
+ display: none;
+}
+
+.woo-docs-homepage {
+ --woo-home-lead-width: 48rem;
+ --woo-home-card: #ffffff;
+ --woo-home-border: #e9e1d9;
+ --woo-home-text: #101517;
+ --woo-home-muted: #50575e;
+ --woo-home-accent: #720eec;
+ color: var(--woo-home-text);
+ padding-bottom: 1rem;
+}
+
+[data-theme='dark'] .woo-docs-homepage {
+ --woo-home-card: #202126;
+ --woo-home-border: #48434e;
+ --woo-home-text: #f6f7f7;
+ --woo-home-muted: #c8c4cc;
+ --woo-home-accent: #caaaff;
+}
+
+.woo-docs-homepage__lead {
+ display: grid;
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ gap: clamp(1.5rem, 2vw, 2rem);
+ align-items: start;
+}
+
+.woo-docs-homepage__intro {
+ padding: 1rem 0 0;
+}
+
+.woo-docs-homepage__intro > p {
+ margin-bottom: 0;
+ color: var(--woo-home-muted);
+ font-size: clamp(1rem, 1.4vw, 1.16rem);
+ line-height: 1.65;
+ text-wrap: balance;
+}
+
+.woo-docs-homepage__capability-grid,
+.woo-docs-homepage__directory-grid {
+ display: grid;
+ gap: 1.1rem;
+}
+
+.woo-docs-homepage__setup {
+ min-width: 0;
+ padding-block-start: 1rem;
+}
+
+.woo-docs-homepage__setup-tabs {
+ padding-inline-start: 1.25rem;
+}
+
+.woo-docs-homepage__setup-tabs + .margin-top--md {
+ margin-top: 0 !important;
+}
+
+.woo-docs-homepage__setup [role='tabpanel'] {
+ min-width: 0;
+ padding: 1.25rem;
+ border: 1px solid var(--woo-home-border);
+ border-radius: 10px;
+}
+
+.woo-docs-homepage__setup [role='tabpanel'] > p:last-child {
+ margin-bottom: 0;
+}
+
+.woo-docs-homepage__setup .theme-code-block {
+ width: 100%;
+ overflow: hidden;
+ border-radius: 10px;
+ box-shadow: none;
+}
+
+.woo-docs-homepage__setup .theme-code-block button[aria-label='Copy code to clipboard'] {
+ opacity: 1;
+}
+
+.woo-docs-homepage__setup pre,
+.woo-docs-homepage__setup pre code {
+ white-space: pre-wrap;
+ overflow-wrap: anywhere;
+}
+
+.woo-docs-homepage > h2 {
+ margin: 3.5rem 0 0.55rem;
+ font-size: clamp(1.9rem, 3vw, 2.4rem);
+}
+
+.woo-docs-homepage > h2 + p {
+ max-width: 70ch;
+ margin-bottom: 1.35rem;
+ color: var(--woo-home-muted);
+}
+
+.woo-docs-homepage__capability-grid {
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ margin-top: 1.25rem;
+}
+
+.woo-docs-homepage__capability-card {
+ display: flex;
+ min-width: 0;
+ flex-direction: column;
+ padding: 1.6rem;
+ border: 1px solid var(--woo-home-border);
+ border-radius: 16px;
+ background: var(--woo-home-card);
+ box-shadow: 0 5px 20px rgba(29, 35, 39, 0.035);
+}
+
+.woo-docs-homepage__capability-card::before {
+ content: '';
+ width: 2rem;
+ height: 0.22rem;
+ margin-bottom: 1.2rem;
+ border-radius: 2px;
+ background: var(--woo-home-accent);
+}
+
+.woo-docs-homepage__capability-card h3,
+.woo-docs-homepage__directory-card h3 {
+ margin: 0 0 0.8rem;
+ font-size: 1.35rem;
+}
+
+.woo-docs-homepage__capability-card p {
+ margin: 0 0 1.2rem;
+ color: var(--woo-home-muted);
+}
+
+.woo-docs-homepage__capability-card p:not(:last-child) {
+ text-wrap: balance;
+}
+
+.woo-docs-homepage__capability-card p:last-child {
+ margin: auto 0 0;
+}
+
+.woo-docs-homepage__capability-card p:last-child a {
+ font-weight: 700;
+ text-decoration: none;
+}
+
+.woo-docs-homepage__capability-card p:last-child a::after {
+ content: ' →';
+}
+
+.woo-docs-homepage__resource-list ul {
+ display: grid;
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ gap: 0.8rem;
+ padding: 0;
+ margin: 0;
+ list-style: none;
+}
+
+.woo-docs-homepage__resource-list li {
+ min-width: 0;
+ padding: 1rem 1.1rem;
+ margin: 0;
+ border: 1px solid var(--woo-home-border);
+ border-radius: 12px;
+ background: var(--woo-home-card);
+ font-size: 0.94rem;
+ text-wrap: balance;
+}
+
+.woo-docs-homepage__resource-list li a {
+ display: block;
+ margin-bottom: 0.2rem;
+ font-size: 1rem;
+ font-weight: 700;
+ text-decoration: none;
+}
+
+.woo-docs-homepage__directory-grid {
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ margin-top: 1.3rem;
+}
+
+.woo-docs-homepage__directory-card {
+ min-width: 0;
+ padding: 1.45rem;
+ border: 1px solid var(--woo-home-border);
+ border-radius: 14px;
+ background: var(--woo-home-card);
+}
+
+.woo-docs-homepage__directory-card ul {
+ padding: 0;
+ margin: 0;
+ list-style: none;
+}
+
+.woo-docs-homepage__directory-card li {
+ padding: 0.43rem 0;
+ margin: 0;
+ border-top: 1px solid var(--woo-home-border);
+}
+
+.woo-docs-homepage__directory-card li:first-child {
+ border-top: 0;
+}
+
+.woo-docs-homepage__directory-card a {
+ text-decoration: none;
+}
+
+.woo-docs-homepage__directory-card a:hover,
+.woo-docs-homepage__capability-card a:hover,
+.woo-docs-homepage__resource-list a:hover {
+ text-decoration: underline;
+}
+
+.woo-docs-homepage a:focus-visible {
+ outline: 2px solid #873eff;
+ outline-offset: 3px;
+}
+
+@media (max-width: 1100px) {
+ .woo-docs-homepage__lead {
+ grid-template-columns: 1fr;
+ gap: 0;
+ }
+
+ .woo-docs-homepage__intro {
+ max-width: var(--woo-home-lead-width);
+ padding: 2rem 0 2.5rem;
+ }
+
+ .woo-docs-homepage__setup {
+ max-width: var(--woo-home-lead-width);
+ padding-block-start: 0;
+ }
+
+ .woo-docs-homepage__capability-grid,
+ .woo-docs-homepage__directory-grid,
+ .woo-docs-homepage__resource-list ul {
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ }
+}
+
+@media (max-width: 640px) {
+ .woo-docs-homepage__setup .theme-code-block pre {
+ padding-block-start: 3.1rem;
+ }
+
+ .woo-docs-homepage__capability-grid,
+ .woo-docs-homepage__directory-grid,
+ .woo-docs-homepage__resource-list ul {
+ grid-template-columns: 1fr;
+ }
+
+ .woo-docs-homepage > h2 {
+ margin-top: 2.8rem;
+ }
+}
diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md
index 3fa69a1e9b5..9be84e955e4 100644
--- a/docs/getting-started/README.md
+++ b/docs/getting-started/README.md
@@ -1,63 +1,225 @@
---
slug: /
sidebar_position: 0
-sidebar_label: 'Getting Started'
+sidebar_label: 'Getting started'
+title: 'WooCommerce Developer Docs'
+hide_title: true
+hide_table_of_contents: true
---
-# Getting started
+{/* <!-- markdownlint-disable MD033 MD041 --> */}
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<div className="woo-docs-homepage">
+
+<div className="woo-docs-homepage__lead">
+
+<div className="woo-docs-homepage__intro">
+
+<h1>WooCommerce Developer Docs</h1>
WooCommerce is a customizable, open-source eCommerce platform built on WordPress. It empowers businesses worldwide to sell anything from physical products and digital downloads to subscriptions, content, and even appointments.
-* Get familiar with [WordPress Plugin Development](https://developer.wordpress.org/plugins/).
-* Take a moment to familiarize yourself with our [Developer Resources](https://developer.wordpress.org/plugins/plugin-basics/).
-* Join the [Woo Community Slack](https://woo.com/community-slack/)
+</div>
----
+<div className="woo-docs-homepage__setup">
-## Build WooCommerce extensions
+<Tabs className="woo-docs-homepage__setup-tabs">
-Explore comprehensive guides and resources to build and enhance WooCommerce extensions. Dive into development best practices and innovative techniques for creating powerful extensions.
+<TabItem value="manual" label="Command" default>
-* [How to build your first extension](/docs/extensions/getting-started-extensions/building-your-first-extension)
-* [Designing a simple extension](/docs/extensions/getting-started-extensions/how-to-design-a-simple-extension)
-* [Extension development best practices](/docs/extensions/best-practices-extensions/extension-development-best-practices)
+```bash
+# Install the Studio CLI if needed (macOS and Linux).
+curl -fsSL https://wordpress.studio/install.sh | bash
-Learn more about [extension development](/docs/extensions/getting-started-extensions/)
+# In a new terminal and empty directory, start a Woo store.
+studio blueprint use woo-shop
+```
----
+Studio starts the local site and gives you its URL. For setup details, other local environments, and working with WooCommerce Core, read [Set up your development environment](/docs/getting-started/development-environment/).
-## Build WooCommerce themes
+</TabItem>
-Discover the art of WooCommerce theme development. Learn about theme customization, design principles, and enhancing user experience to create visually appealing and functional themes.
+<TabItem value="agent" label="Agent prompt">
-* [How to set up and use a child theme](/docs/theming/theme-development/set-up-a-child-theme)
-* [Classic theme developer handbook](/docs/theming/theme-development/classic-theme-developer-handbook)
-* [Theme design and user experience guidelines](/docs/theming/theme-development/theme-design-ux-guidelines)
+Copy this prompt into a coding agent with terminal access.
-Learn more about [classic theme development](/docs/theming/theme-development/classic-theme-developer-handbook) or [Block theme development](/docs/theming/block-theme-development/theming-woo-blocks)
+```text
+Fetch the instructions from https://developer.woocommerce.com/docs/llms.txt.
+```
----
+</TabItem>
-## Contribute to WooCommerce
+</Tabs>
-Join our open-source community and contribute to WooCommerce. Explore how you can make a difference by tackling open issues and enhancing the WooCommerce ecosystem.
+</div>
-* [Visit the WooCommerce monorepo](https://github.com/woocommerce/woocommerce)
-* [Open Issues on GitHub](https://github.com/woocommerce/woocommerce/issues)
-* [Woo contributor guidelines](/docs/contribution/contributing/)
+</div>
-Learn more about [contributing](/docs/contribution/contributing)
+## Build and extend WooCommerce
----
+Choose a starting point for the work you want to do. Each guide has the full setup and implementation details.
-## Additional resources
+<div className="woo-docs-homepage__capability-grid">
-* [WooCommerce Official Website](https://woocommerce.com/)
-* [Woo Marketplace](https://woocommerce.com/marketplace)
-* All [WooCommerce Repositories on GitHub](https://woocommerce.github.io/)
+<section className="woo-docs-homepage__capability-card">
----
+### Extensions
+
+Add functionality to a Woo store, such as store settings, payment methods, or shipping options.
+
+[Build your first extension](/docs/extensions/getting-started-extensions/building-your-first-extension/)
+
+</section>
+
+<section className="woo-docs-homepage__capability-card">
+
+### Storefronts and themes
+
+Create and customize shopper-facing templates and styles with WooCommerce block themes or classic themes.
+
+[Develop a block theme](/docs/theming/block-theme-development/theming-woo-blocks/)
+
+</section>
+
+<section className="woo-docs-homepage__capability-card">
+
+### REST APIs
+
+Use the REST API for store management data. Use the Store API for shopper-facing product, cart, and checkout flows.
+
+[REST API](/docs/apis/rest-api/) · [Store API](/docs/apis/store-api/)
+
+</section>
+
+<section className="woo-docs-homepage__capability-card">
+
+### WooCommerce CLI
+
+Manage products, orders, and store settings from the command line with `wp wc`.
+
+[Explore WooCommerce CLI](/docs/wc-cli/cli-overview/)
+
+</section>
+
+<section className="woo-docs-homepage__capability-card">
+
+### WooCommerce MCP
+
+Connect a compatible AI client to a running store through the WordPress MCP Adapter and WooCommerce abilities. This integration is a developer preview.
+
+[Set up WooCommerce MCP](/docs/features/mcp/)
+
+</section>
+
+<section className="woo-docs-homepage__capability-card">
+
+### Contribute to WooCommerce
+
+Fix bugs, improve documentation, and help test WooCommerce in the open-source project.
+
+[Read the contributor guide](/docs/contribution/contributing/)
+
+</section>
+
+</div>
+
+## Popular resources
+
+Find releases, changes, and extensions.
+
+<div className="woo-docs-homepage__resource-list">
+
+- [Releases](https://developer.woocommerce.com/releases/) Find WooCommerce Core release downloads.
+- [Changelog](https://developer.woocommerce.com/changelog/) Read recent release notes.
+- [Woo Marketplace](https://woocommerce.com/product-category/woocommerce-extensions/) Browse extensions for your store.
+
+</div>
+
+## Browse the docs
+
+The directory below keeps the broader guides, feature docs, examples, and references in view.
+
+<div className="woo-docs-homepage__directory-grid">
+
+<section className="woo-docs-homepage__directory-card">
+
+### Getting started
+
+- [Project structure](/docs/getting-started/project-structure/)
+- [Local development](/docs/getting-started/development-environment/)
+- [Scaffolding and sample data](/docs/getting-started/scaffolding/)
+- [Developer tools](/docs/getting-started/developer-tools/)
+- [Debugging](/docs/getting-started/debugging/)
+- [AI](/docs/getting-started/ai/)
+
+</section>
+
+<section className="woo-docs-homepage__directory-card">
+
+### Extensions
+
+- [Extension development](/docs/extensions/getting-started-extensions/)
+- [Designing an extension](/docs/extensions/getting-started-extensions/how-to-design-a-simple-extension/)
+- [Extension best practices](/docs/extensions/best-practices-extensions/extension-development-best-practices/)
+
+</section>
+
+<section className="woo-docs-homepage__directory-card">
+
+### Theming and blocks
+
+- [Block theme development](/docs/theming/block-theme-development/theming-woo-blocks/)
+- [Child themes](/docs/theming/theme-development/set-up-a-child-theme/)
+- [Classic theme handbook](/docs/theming/theme-development/classic-theme-developer-handbook/)
+- [Theme design guidelines](/docs/theming/theme-development/theme-design-ux-guidelines/)
+- [Block development](/docs/block-development/)
+
+</section>
+
+<section className="woo-docs-homepage__directory-card">
+
+### Features
+
+- [Products](/docs/features/products/wc-get-products/)
+- [Orders](/docs/features/orders/wc-get-orders/)
+- [Payments](/docs/features/payments/payment-gateway-api/)
+- [Shipping](/docs/features/shipping/shipping-method-api/)
+- [Analytics](/docs/features/analytics/extending-woocommerce-admin-reports/)
+
+</section>
+
+<section className="woo-docs-homepage__directory-card">
+
+### Best practices
+
+- [Security](/docs/best-practices/security/security-best-practices/)
+- [Performance](/docs/best-practices/performance/performance-best-practices/)
+- [Data management](/docs/best-practices/data-management/crud-objects/)
+- [Webhooks](/docs/best-practices/urls-and-routing/webhooks/)
+
+</section>
+
+<section className="woo-docs-homepage__directory-card">
+
+### Code snippets and references
+
+- [Code snippets](/docs/code-snippets/)
+- [WooCommerce Code Reference](https://woocommerce.github.io/code-reference/)
+- [REST API v3](/docs/apis/rest-api/v3/)
+- [Store API endpoints](/docs/apis/store-api/resources-endpoints/products/)
+- [WooCommerce CLI](/docs/wc-cli/cli-overview/)
+
+</section>
+
+</div>
+
+## More ways to learn and contribute
+
+Start with the [WordPress Plugin Handbook](https://developer.wordpress.org/plugins/) and [plugin basics](https://developer.wordpress.org/plugins/plugin-basics/) if you are new to WordPress development. Find the [WooCommerce monorepo](https://github.com/woocommerce/woocommerce), [open issues](https://github.com/woocommerce/woocommerce/issues), [all WooCommerce repositories](https://woocommerce.github.io/), and [Woo community Slack](https://woo.com/community-slack/).
-## Not a developer?
+For store setup and merchant tasks, visit the [WooCommerce website](https://woocommerce.com/), [Woo Marketplace](https://woocommerce.com/marketplace), and [merchant documentation](https://woocommerce.com/documentation/woocommerce/).
-This documentation site is intended for developers. If you're a merchant or are new to WooCommerce, please check out [woocommerce.com](https://woocommerce.com/) for our merchant-facing docs.
+</div>
diff --git a/docs/getting-started/ai.md b/docs/getting-started/ai.md
index 7916c203936..2b53b4fcec4 100644
--- a/docs/getting-started/ai.md
+++ b/docs/getting-started/ai.md
@@ -10,28 +10,23 @@ This guide provides an overview of AI tools and how to use them to enhance your
## MCP
-WooCommerce includes native support for the Model Context Protocol (MCP), enabling AI assistants and tools to interact directly with WooCommerce stores through a standardized protocol. Visit our full [MCP documentation](/docs/features/mcp/) for more information.
+WooCommerce registers product and order abilities that compatible AI clients can use through the WordPress MCP Adapter. This integration is a developer preview. See the [MCP documentation](/docs/features/mcp/) for setup and permissions.
-## AI Documentation Tools
+## AI documentation tools
-### LLMS.txt Files
+### Curated documentation index
-To feed the WooCommerce Developer Documentation into your LLM or AI-assisted IDE, you have two options:
+The [curated `llms.txt` index](https://developer.woocommerce.com/docs/llms.txt) links directly to Markdown versions of starting points and key references for WooCommerce development. Choose the guides relevant to your task, then open the individual pages for full instructions.
-1. [`llms.txt`](https://developer.woocommerce.com/docs/llms.txt) - A table of contents that includes the title, URL, and description of each document in the developer docs.
-2. [`llms-full.txt`](https://developer.woocommerce.com/docs/llms-full.txt) - A full Markdown-formatted export of the entire documentation in one file.
-
-If you are using an IDE like Cursor or Windsurf, we recommend adding these links as custom documentation so that you can reference them as needed.
-
-**Note** that these do not include the contents of the [WooCommerce Code Reference](https://woocommerce.github.io/code-reference/).
+The index does not include the contents of the [WooCommerce Code Reference](https://woocommerce.github.io/code-reference/).
### Serve as Markdown
-If you want to view the documentation as Markdown files, you can use append `.md` to the end of any documentation URL. For example, to view this page as Markdown, you can visit:
+To read an individual documentation page as Markdown, append `.md` to its URL. For example, this page is available at:
-```plain
+```text
https://developer.woocommerce.com/docs/getting-started/ai.md
-```
+```
### Copy to Markdown
diff --git a/docs/getting-started/scaffolding.md b/docs/getting-started/scaffolding.md
index 53f53a0ba04..6c182bf8356 100644
--- a/docs/getting-started/scaffolding.md
+++ b/docs/getting-started/scaffolding.md
@@ -59,6 +59,20 @@ Read more about the [`wordpress/create-block` package](https://developer.wordpre
## Sample Store Data
+### Woo Store Blueprints with Mock Data
+
+[WordPress Studio Blueprints](https://wordpress.studio/docs/blueprints/) can create a local WooCommerce store with the Purple theme, a store-specific homepage, and a small catalog of fictional sample products. Use one when you need products to explore a theme, extension, or API integration.
+
+Install or enable the [Studio CLI](https://wordpress.studio/docs/cli/) first. Run `studio blueprint list` to see the available Blueprints. From a new, empty directory, use the command for the sample store you want:
+
+| Store | Command |
+| --- | --- |
+| Apparel | `studio blueprint use woo-apparel` |
+| Beauty + Wellness | `studio blueprint use woo-beauty-wellness` |
+| Digital Goods | `studio blueprint use woo-digital-goods` |
+| Food + Drink | `studio blueprint use woo-food-drink` |
+| Home + Living | `studio blueprint use woo-home-living` |
+
### Core Plugin Sample Data
It may be helpful to load your local store with sample data. In the WooCommerce core plugin, you can find CSV and XML files that can be imported directly into WooCommerce using the WordPress admin or via WC-CLI. The sample data is located in [`/plugins/woocommerce/sample-data/`](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce/sample-data).