refactor: move contracts under Build > API, merge manuals into guides

docs/build/api/_category_.json

@@ -0,0 +1,9 @@
+{
+  "label": "API",
+  "position": 3,
+  "link": {
+    "type": "generated-index"
+  },
+  "collapsible": false,
+  "collapsed": false
+}

docs/build/api/contracts/_category_.json

@@ -0,0 +1,10 @@
+{
+  "label": "Contracts",
+  "position": 1,
+  "link": {
+    "type": "doc",
+    "id": "build/api/contracts/index"
+  },
+  "collapsible": false,
+  "collapsed": false
+}

docs/contracts/api-reference/app-registry.md → docs/build/api/contracts/api-reference/app-registry.md

@@ -2,7 +2,7 @@
 title: "AppRegistry"
 description: "App builder registry with slashing."
 sidebar_position: 4
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # AppRegistry

docs/contracts/api-reference/faucet.md → docs/build/api/contracts/api-reference/faucet.md

@@ -2,7 +2,7 @@
 title: "Faucet"
 description: "Testnet token faucet."
 sidebar_position: 7
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Faucet

docs/contracts/api-reference/interfaces/ilock.md → docs/build/api/contracts/api-reference/interfaces/ilock.md

@@ -2,7 +2,7 @@
 title: "ILock"
 description: "Lock/unlock/withdraw interface."
 sidebar_position: 1
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # ILock

docs/contracts/api-reference/interfaces/islash.md → docs/build/api/contracts/api-reference/interfaces/islash.md

@@ -2,7 +2,7 @@
 title: "ISlash"
 description: "Slashing interface."
 sidebar_position: 2
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # ISlash

docs/contracts/api-reference/locker.md → docs/build/api/contracts/api-reference/locker.md

@@ -2,7 +2,7 @@
 title: "Locker"
 description: "Abstract lock/unlock/withdraw state machine."
 sidebar_position: 2
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Locker

docs/contracts/api-reference/node-registry.md → docs/build/api/contracts/api-reference/node-registry.md

@@ -2,7 +2,7 @@
 title: "NodeRegistry"
 description: "Node operator registry with voting power."
 sidebar_position: 3
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # NodeRegistry

docs/contracts/api-reference/treasury.md → docs/build/api/contracts/api-reference/treasury.md

@@ -2,7 +2,7 @@
 title: "Treasury"
 description: "Secure vault for Foundation assets."
 sidebar_position: 6
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Treasury

docs/contracts/api-reference/yellow-governor.md → docs/build/api/contracts/api-reference/yellow-governor.md

@@ -2,7 +2,7 @@
 title: "YellowGovernor"
 description: "OpenZeppelin Governor for protocol parameters."
 sidebar_position: 5
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # YellowGovernor

docs/contracts/api-reference/yellow-token.md → docs/build/api/contracts/api-reference/yellow-token.md

@@ -2,7 +2,7 @@
 title: "YellowToken"
 description: "ERC-20 token with fixed 10B supply."
 sidebar_position: 1
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # YellowToken

docs/contracts/faq.md → docs/build/api/contracts/faq.md

@@ -2,7 +2,7 @@
 title: "FAQ"
 description: "Frequently asked questions about Yellow Network smart contracts."
 sidebar_position: 7
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Frequently Asked Questions

docs/contracts/addresses.md → docs/build/api/contracts/index.md

@@ -1,8 +1,8 @@
 ---
 title: "Deployed Addresses"
 description: "Mainnet and testnet contract addresses for Yellow Network."
-sidebar_position: 2
-displayed_sidebar: contractsSidebar
+sidebar_position: 1
+displayed_sidebar: buildSidebar
 ---
 
 # Deployed Addresses

docs/contracts/integration/deployment.md → docs/build/api/contracts/integration/deployment.md

@@ -2,7 +2,7 @@
 title: "Deployment"
 description: "Deploying contracts and configuration."
 sidebar_position: 1
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Deployment

docs/contracts/integration/events.md → docs/build/api/contracts/integration/events.md

@@ -2,7 +2,7 @@
 title: "Events"
 description: "Contract events for real-time subscriptions."
 sidebar_position: 2
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Events

docs/contracts/integration/ui-spec.md → docs/build/api/contracts/integration/ui-spec.md

@@ -2,7 +2,7 @@
 title: "UI Specification"
 description: "Frontend implementation guide."
 sidebar_position: 3
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # UI Specification

docs/contracts/protocol/governance.md → docs/build/api/contracts/protocol/governance.md

@@ -2,7 +2,7 @@
 title: "Governance"
 description: "On-chain parameter administration via YellowGovernor."
 sidebar_position: 2
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Protocol Parameter Administration

docs/contracts/protocol/overview.md → docs/build/api/contracts/protocol/overview.md

@@ -2,7 +2,7 @@
 title: "Protocol Overview"
 description: "Architecture, contracts, and how they fit together."
 sidebar_position: 1
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Protocol Overview

docs/contracts/protocol/slashing.md → docs/build/api/contracts/protocol/slashing.md

@@ -2,7 +2,7 @@
 title: "Slashing"
 description: "Adjudicator slashing and cooldown mechanism."
 sidebar_position: 4
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Slashing

docs/contracts/protocol/staking.md → docs/build/api/contracts/protocol/staking.md

@@ -2,7 +2,7 @@
 title: "Collateral & Staking"
 description: "Lock/unlock state machine for NodeRegistry and AppRegistry."
 sidebar_position: 3
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Collateral

docs/contracts/protocol/treasury.md → docs/build/api/contracts/protocol/treasury.md

@@ -2,7 +2,7 @@
 title: "Treasury"
 description: "Foundation asset management."
 sidebar_position: 5
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # Treasury

docs/contracts/sdk/_category_.json → docs/build/api/contracts/sdk/_category_.json

@@ -1,6 +1,7 @@
 {
   "label": "SDK",
   "position": 5,
+  "key": "contracts-sdk",
   "link": {
     "type": "generated-index"
   },

docs/contracts/sdk/api-reference.md → docs/build/api/contracts/sdk/api-reference.md

@@ -2,7 +2,7 @@
 title: "SDK API Reference"
 description: "All exports: ABIs, addresses, and types."
 sidebar_position: 2
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # SDK — API Reference
@@ -86,4 +86,4 @@ type ContractAddresses = {
 
 ### Current Addresses
 
-See [Deployed Addresses](../operations/addresses.md) for the full list.
+See [Deployed Addresses](../index.md) for the full list.

docs/contracts/sdk/examples.md → docs/build/api/contracts/sdk/examples.md

@@ -2,7 +2,7 @@
 title: "Examples"
 description: "Code samples for viem, ethers.js, and wagmi."
 sidebar_position: 3
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # SDK — Examples

docs/contracts/sdk/getting-started.md → docs/build/api/contracts/sdk/getting-started.md

@@ -2,7 +2,7 @@
 title: "Getting Started"
 description: "Install, import, and use the contracts SDK."
 sidebar_position: 1
-displayed_sidebar: contractsSidebar
+displayed_sidebar: buildSidebar
 ---
 
 # SDK — Getting Started

docs/build/quick-start/index.md

@@ -347,7 +347,7 @@ await app.sendPayment('100000', '0xPartnerAddress'); // Send 0.1 USDC
 
 Congratulations! You've built your first Yellow App. Here's what to explore next:
 
-- **[Advanced Topics](../../learn/advanced/architecture)**: Learn about architecture, multi-party applications, and production deployment
+- **[Advanced Topics](../../learn/introduction/architecture-at-a-glance)**: Learn about architecture, multi-party applications, and production deployment
 - **[API Reference](../../api-reference)**: Explore all available SDK methods and options
 
 ## Need Help?