[validate-docs] ♻️ group Validate pages under /validate and rename connection guides

src/pages/config.md

@@ -3,17 +3,17 @@
 
 - pages:
     - [Adobe Brand Intelligence APIs](/index.md)
-    - [Guides](/guides/index.md)
+    - [Validate](/validate/index.md)
     - API Reference
-        - [Brand Intelligence API](/api/index.md)
-        - [MCP Tools](/api/mcp/index.md)
+        - [Validate REST API](/validate/api/rest/index.md)
+        - [Validate MCP Tools](/validate/api/mcp/index.md)
     - [Support](/support/index.md)
 
 - subPages:
-    - [Guides](/guides/index.md)
-        - [Authentication](/guides/authentication/index.md)
-        - [Core Concepts](/guides/core-concepts/index.md)
-        - [MCP Integration](/guides/mcp-integration/index.md)
-        - [Quickstart](/guides/quickstart/index.md)
-        - [Review Feedback](/guides/review-feedback/index.md)
-        - [Using Postman](/guides/using-postman/index.md)
+    - [Validate](/validate/index.md)
+        - [Core Concepts](/validate/core-concepts/index.md)
+        - [Authentication](/validate/authentication/index.md)
+        - [Using MCP](/validate/using-mcp/index.md)
+        - [Using Postman](/validate/using-postman/index.md)
+        - [Using curl](/validate/using-curl/index.md)
+        - [Review Feedback](/validate/review-feedback/index.md)

src/pages/index.md

@@ -18,34 +18,34 @@ Adobe Brand Intelligence is an AI-powered brand compliance service for enterpris
 Use the Brand Intelligence API to:
 
 - **Validate assets in bulk** - submit a batch of assets and receive structured pass/fail feedback per asset.
-- **Manage review feedback** - attach structured violations to flagged assets and track reviewer acceptance or rejection. See [Review Feedback](guides/review-feedback/index.md).
+- **Manage review feedback** - attach structured violations to flagged assets and track reviewer acceptance or rejection. See [Review Feedback](validate/review-feedback/index.md).
 
 ## Discover
 
 <DiscoverBlock slots="heading, link, text"/>
 
 ### Get Started
 
-[Core Concepts](guides/core-concepts/index.md)
+[Core Concepts](validate/core-concepts/index.md)
 
 Understand the async invocation model, the Invocation → Items → Violations resource hierarchy, and how validation results are structured.
 
 <DiscoverBlock slots="link, text"/>
 
-[Authentication](guides/authentication/index.md)
+[Authentication](validate/authentication/index.md)
 
 Set up OAuth Server-to-Server credentials in Adobe Developer Console and generate your first access token.
 
 <DiscoverBlock slots="link, text"/>
 
-[Quickstart](guides/quickstart/index.md)
+[Using curl](validate/using-curl/index.md)
 
 Submit your first validation invocation and retrieve results with step-by-step `curl` examples.
 
 <DiscoverBlock slots="heading, link, text"/>
 
 ### API Reference
 
-[Brand Intelligence API](api/index.md)
+[Brand Intelligence API](validate/api/rest/index.md)
 
 Full OpenAPI reference for the Validation endpoints.

src/pages/redirects.json

@@ -0,0 +1,116 @@
+{
+  "total": 27,
+  "offset": 0,
+  "limit": 27,
+  "data": [
+    {
+      "Source": "/adobe-brand-intelligence/guides",
+      "Destination": "/adobe-brand-intelligence/validate/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/",
+      "Destination": "/adobe-brand-intelligence/validate/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/index",
+      "Destination": "/adobe-brand-intelligence/validate/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/authentication",
+      "Destination": "/adobe-brand-intelligence/validate/authentication/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/authentication/",
+      "Destination": "/adobe-brand-intelligence/validate/authentication/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/authentication/index",
+      "Destination": "/adobe-brand-intelligence/validate/authentication/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/core-concepts",
+      "Destination": "/adobe-brand-intelligence/validate/core-concepts/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/core-concepts/",
+      "Destination": "/adobe-brand-intelligence/validate/core-concepts/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/core-concepts/index",
+      "Destination": "/adobe-brand-intelligence/validate/core-concepts/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/mcp-integration",
+      "Destination": "/adobe-brand-intelligence/validate/using-mcp/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/mcp-integration/",
+      "Destination": "/adobe-brand-intelligence/validate/using-mcp/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/mcp-integration/index",
+      "Destination": "/adobe-brand-intelligence/validate/using-mcp/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/quickstart",
+      "Destination": "/adobe-brand-intelligence/validate/using-curl/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/quickstart/",
+      "Destination": "/adobe-brand-intelligence/validate/using-curl/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/quickstart/index",
+      "Destination": "/adobe-brand-intelligence/validate/using-curl/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/using-postman",
+      "Destination": "/adobe-brand-intelligence/validate/using-postman/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/using-postman/",
+      "Destination": "/adobe-brand-intelligence/validate/using-postman/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/using-postman/index",
+      "Destination": "/adobe-brand-intelligence/validate/using-postman/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/review-feedback",
+      "Destination": "/adobe-brand-intelligence/validate/review-feedback/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/review-feedback/",
+      "Destination": "/adobe-brand-intelligence/validate/review-feedback/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/guides/review-feedback/index",
+      "Destination": "/adobe-brand-intelligence/validate/review-feedback/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/api",
+      "Destination": "/adobe-brand-intelligence/validate/api/rest/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/api/",
+      "Destination": "/adobe-brand-intelligence/validate/api/rest/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/api/index",
+      "Destination": "/adobe-brand-intelligence/validate/api/rest/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/api/mcp",
+      "Destination": "/adobe-brand-intelligence/validate/api/mcp/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/api/mcp/",
+      "Destination": "/adobe-brand-intelligence/validate/api/mcp/"
+    },
+    {
+      "Source": "/adobe-brand-intelligence/api/mcp/index",
+      "Destination": "/adobe-brand-intelligence/validate/api/mcp/"
+    }
+  ],
+  ":type": "sheet"
+}

src/pages/guides/core-concepts/index.md → src/pages/validate/core-concepts/index.md

@@ -29,7 +29,7 @@ This design keeps the API responsive for large batches.
 
 Each item you submit declares an `itemSource` telling Brand Intelligence where to read the asset from:
 
-- **`blob`** - the asset lives in Brand Intelligence's own storage. Upload it first via `POST /api/abi/storage/temp`, then reference the returned `itemId` as the item's `sourceRef`. See [Quickstart](../quickstart/index.md) for the full upload flow.
+- **`blob`** - the asset lives in Brand Intelligence's own storage. Upload it first via `POST /api/abi/storage/temp`, then reference the returned `itemId` as the item's `sourceRef`. See [Using curl](../using-curl/index.md) for the full upload flow.
 - **`web`** - the asset is already reachable at a public URL. Set `sourceRef` to that URL directly; no upload step is needed.
 
 
@@ -93,7 +93,7 @@ Each item's detail (`GET /api/abi/skills/ra/{invocationId}/items/{itemId}`) cont
 
 An item with an empty `violations` array is fully compliant. See [Review Feedback](../review-feedback/index.md) for how to accept, reject, or add violations.
 
-See the [API Reference](../../api/index.md) for the full `RaItemViolation` schema.
+See the [API Reference](../api/rest/index.md) for the full `RaItemViolation` schema.
 
 
 ## Pagination

src/pages/validate/index.md

@@ -0,0 +1,31 @@
+---
+title: Validate - Brand Intelligence
+description: Guides for validating creative assets against brand guidelines with Adobe Brand Intelligence.
+---
+
+# Validate
+
+Validate checks creative assets against your organization's brand guidelines. These guides walk you through everything you need to integrate with it.
+
+## Get started
+
+| Guide | Description |
+|-------|-------------|
+| [Core Concepts](core-concepts/index.md) | Key concepts: async invocations, validation results, and the resource model. |
+| [Authentication](authentication/index.md) | Set up OAuth credentials and generate an access token. |
+
+## Choose how to connect
+
+| Guide | Description |
+|-------|-------------|
+| [Using MCP](using-mcp/index.md) | Integrate Validate into your own chat assistant via its MCP server. |
+| [Using Postman](using-postman/index.md) | Explore and test the API using Postman. |
+| [Using curl](using-curl/index.md) | Submit your first validation invocation end to end with `curl`. |
+
+## Go further
+
+| Guide | Description |
+|-------|-------------|
+| [Review Feedback](review-feedback/index.md) | Attach and manage reviewer feedback on validation results. |
+| [REST API Reference](api/rest/index.md) | Full OpenAPI reference for the Validate REST endpoints. |
+| [MCP Tools Reference](api/mcp/index.md) | Request and response schemas for the Validate MCP tools. |

src/pages/guides/review-feedback/index.md → src/pages/validate/review-feedback/index.md

@@ -67,7 +67,7 @@ curl --request GET \
 }
 ```
 
-Each violation may also include `assetAttributions` and `corpusAttributions` linking back to the specific regions in the asset and the guideline chunks that informed the finding. `reviewStatus` is `null` until a reviewer accepts or rejects the violation. See the [API Reference](../../api/index.md) for the full `RaItemViolation` schema.
+Each violation may also include `assetAttributions` and `corpusAttributions` linking back to the specific regions in the asset and the guideline chunks that informed the finding. `reviewStatus` is `null` until a reviewer accepts or rejects the violation. See the [API Reference](../api/rest/index.md) for the full `RaItemViolation` schema.
 
 
 ## Add a violation
@@ -154,5 +154,5 @@ curl --request PATCH \
 
 ## What's next
 
-- See the full schema for violations in the [API Reference](../../api/index.md).
+- See the full schema for violations in the [API Reference](../api/rest/index.md).
 - Return to [Core Concepts](../core-concepts/index.md) for an overview of the Invocation → Item → Violation hierarchy.

src/pages/guides/quickstart/index.md → src/pages/validate/using-curl/index.md

@@ -1,9 +1,9 @@
 ---
-title: Quickstart - Brand Intelligence
+title: Using curl - Brand Intelligence Validate
 description: Submit your first asset validation invocation using the Adobe Brand Intelligence API.
 ---
 
-# Quickstart
+# Using curl
 
 This guide walks you through the complete validation flow - from getting an access token to reading per-asset results - using `curl`.
 
@@ -274,11 +274,11 @@ curl --request GET \
 }
 ```
 
-The response includes additional fields per item and per violation - see the [API Reference](../../api/index.md) for the full schema.
+The response includes additional fields per item and per violation - see the [API Reference](../api/rest/index.md) for the full schema.
 
 
 ## What's next
 
-- Explore all available endpoints in the [API Reference](../../api/index.md).
+- Explore all available endpoints in the [API Reference](../api/rest/index.md).
 - Learn how to [attach reviewer feedback](../review-feedback/index.md) to flagged assets.
 - Try the API interactively with [Postman](../using-postman/index.md).

src/pages/guides/mcp-integration/index.md → src/pages/validate/using-mcp/index.md

@@ -1,9 +1,9 @@
 ---
-title: MCP Integration - Brand Intelligence
+title: Using MCP - Brand Intelligence Validate
 description: Integrate Adobe Brand Intelligence Validate into your own chat assistant via its MCP server.
 ---
 
-# MCP Integration
+# Using MCP
 
 This guide is for teams integrating **Adobe Brand Intelligence Validate** into their own chat assistant via its MCP (Model Context Protocol) server.
 
@@ -125,7 +125,7 @@ route directly.
 
 ## 5. Reference
 
-The [MCP Tools Reference](../../api/mcp/index.md) is a machine-readable OpenAPI
+The [MCP Tools Reference](../api/mcp/index.md) is a machine-readable OpenAPI
 3.1 description of the 7 Validate tools' request/response schemas — useful
 for validating your own integration's shapes against the real contract. Its
 per-tool `POST /tools/<name>` paths are a documentation convention only, not

src/pages/guides/using-postman/index.md → src/pages/validate/using-postman/index.md

@@ -63,7 +63,7 @@ Tokens are valid for 24 hours. Re-run this request when your token expires.
 
 You can import the Brand Intelligence OpenAPI spec directly into Postman to auto-generate a request collection:
 
-1. Open the [API Reference](../../api/index.md) page and use its **Download OpenAPI specification** link to save the spec file.
+1. Open the [API Reference](../api/rest/index.md) page and use its **Download OpenAPI specification** link to save the spec file.
 2. In Postman, select **Import** and choose the downloaded file.
 3. Postman will generate a collection with all available endpoints pre-populated.
 4. Set the collection's **Authorization** to **Bearer Token** and set the token value to `{{access_token}}`.
@@ -143,4 +143,4 @@ Repeat until `status` is `completed`, `failed`, or `cancelled`.
 - **GET** `{{base_url}}/api/abi/skills/ra/{{invocation_id}}/items`
 - **Authorization:** Bearer Token → `{{access_token}}`
 
-See the [Quickstart](../quickstart/index.md) for annotated example responses.
+See the [Using curl](../using-curl/index.md) for annotated example responses.