Up v3 docs

AGENTS.md

@@ -7,7 +7,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - Start local docs server: `npm start`
 - Build documentation: `npm run build`
 - Serve built documentation: `npm run serve`
-- Process CRDs: `npm run process-crds`
 - Clear Docusaurus cache: `npm run clear`
 - Deploy documentation: `npm run deploy`
 - Generate translations: `npm run write-translations`
@@ -38,5 +37,4 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - This is a Docusaurus site, not Hugo
 - Requires Node.js 18.x and npm 9.x
 - Use `npm start` for local development with hot reloading
-- CRDs are processed via script before start/build commands
 - Site uses React components and MDX for enhanced functionality

CONTRIBUTING.md

@@ -57,6 +57,24 @@ make build
 
 All PRs require maintainer approval to merge, regardless of Vale status.
 
+## Updating CRDs
+
+CRD reference pages (`docs/reference/apis/*`) render live from raw CRD YAML
+files committed under `static/crds/<product>/`. There's no generation step —
+Docusaurus serves `static/` files as-is, and the `CrdDocViewer` component
+fetches the YAML client-side by URL:
+
+```mdx
+<CrdDocViewer crdUrl="/crds/testing/meta.dev.upbound.io_compositiontests.yaml" />
+```
+
+To add or update a CRD:
+
+1. Copy the CRD's YAML file from its source repo (UXP, Crossplane, Spaces,
+   etc.) into the matching `static/crds/<product>/` directory.
+2. Reference it from the relevant page with `<CrdDocViewer crdUrl="/crds/..." />`.
+3. Commit the YAML file alongside your doc changes in the same PR.
+
 ## VSCode Setup (Recommended)
 
 For the best documentation editing experience, install these extensions:

Makefile

@@ -33,7 +33,7 @@ VALE_BINARY := vale_$(VALE_VERSION)_$(VALE_OS)_$(VALE_ARCH).tar.gz
 VALE_INSTALL_DIR := ./bin
 VALE_EXEC := $(VALE_INSTALL_DIR)/vale
 
-.PHONY: help install-vale vale vale-docs vale-file vale-summary clean build start serve process-crds
+.PHONY: help install-vale vale vale-docs vale-file vale-summary clean build start serve
 
 # Default target
 help: ## Show this help message
@@ -46,7 +46,7 @@ help: ## Show this help message
 install: ## Install dependencies
 	npm install
 
-build: process-crds ## Build the documentation site
+build: ## Build the documentation site
 	npm run build
 
 start: ## Start local development server
@@ -55,9 +55,6 @@ start: ## Start local development server
 serve: ## Serve built documentation
 	npm run serve
 
-process-crds: ## Process CRDs for documentation
-	npm run process-crds
-
 # Vale installation and linting commands
 install-vale: ## Install Vale binary locally
 	@echo "Installing Vale $(VALE_VERSION) for $(VALE_OS) $(VALE_ARCH)..."
@@ -130,7 +127,7 @@ dev: install start ## Install dependencies and start development server
 
 # CI/CD targets
 ci-lint: install-vale vale-summary ## Run linting for CI/CD pipeline
-ci-build: install process-crds build ## Build for CI/CD pipeline
+ci-build: install build ## Build for CI/CD pipeline
 
 # Version info
 version: ## Show versions of tools

README.md

@@ -50,10 +50,9 @@ make check-vale-config
 | Command | Description |
 |---------|-------------|
 | `make install` | Install npm dependencies |
-| `make build` | Build the documentation site (includes CRD processing) |
+| `make build` | Build the documentation site |
 | `make start` | Start local development server with hot reload |
 | `make serve` | Serve the built documentation |
-| `make process-crds` | Process Custom Resource Definitions for documentation |
 | `make dev` | Install dependencies and start development server |
 | `make ci-build` | Full build process for CI/CD |
 

docs/getstarted/upgrade-to-upbound/upgrade-to-mcps.md → cloud-spaces-docs/upgrade-to-mcps.md

@@ -1,6 +1,6 @@
 ---
 title: Upgrade to Spaces
-sidebar_position: 3
+sidebar_position: 4
 description: A guide to how to update to a control plane in an Upbound Space
 ---
 

docs/getstarted/builders-workshop/1-project-foundations.md

@@ -131,7 +131,7 @@ you want to apply to this `StorageBucket` resource.
 
 Paste this XR into your XR file:
 
-<Tabs>
+<Tabs groupId="cloud-provider">
 <TabItem value="aws" label="AWS">
 
 ```yaml title="upbound-hello-world/examples/storagebucket/example.yaml"