feat: restructure docs

Author: anxolin

.claude/settings.local.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm run build:*)",
+      "Bash(find:*)",
+      "Bash({} ;)",
+      "Bash(cat:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

docs/cow-amm/README.mdx

@@ -1,3 +1,8 @@
+---
+sidebar_position: 0
+sidebar_label: "About CoW AMM"
+---
+
 # CoW AMM: The First MEV-capturing AMM
 
 CoW AMM protects LPs from LVR so they can provide liquidity with less risk and more return. CoW AMM achieves close to 5% more in TVL compared to reference pools, protects millions from LVR, and has captured over $100,000 in surplus for LPs to date. 

…-protocol/tutorials/cow-amm-deployer.mdx docs/cow-amm/cow-amm-deployer.mdxdocs/cow-protocol/tutorials/cow-amm-deployer.mdx renamed to docs/cow-amm/cow-amm-deployer.mdx docs/cow-protocol/tutorials/cow-amm-deployer.mdx renamed to docs/cow-amm/cow-amm-deployer.mdx

@@ -1,3 +1,8 @@
+---
+sidebar_position: 0
+sidebar_label: "About CoW Protocol"
+---
+
 # CoW Protocol
 
 CoW Protocol is a meta-DEX aggregation protocol that leverages [trade intents](/cow-protocol/concepts/introduction/intents) and [fair combinatorial batch auctions](/cow-protocol/concepts/introduction/fair-combinatorial-auction) to find users better prices for trading crypto assets.
@@ -18,8 +23,7 @@ Liquidity sources include:
 
 The wide range of liquidity that solvers tap into makes CoW Protocol a meta-DEX aggregator, or an aggregator of aggregators.
 
-**To learn more about the concepts CoW Protocol makes use of, see [Concepts](/category/concepts).**
-
-**For more info on how to use CoW Protocol or CoW Swap, see [Tutorials](/category/tutorials).**
-
-**To dive into the technical details, see [Technical reference](/category/technical-reference).**
+**Use the sidebar to navigate through:**
+- **Concepts** - Learn about the fundamental concepts behind CoW Protocol
+- **Tutorials** - Step-by-step guides for using CoW Protocol
+- **Technical Reference** - APIs, SDKs, and smart contract documentation

docs/cow-protocol/README.mdx

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

docs/cow-protocol/apis/_category_.json

@@ -2,7 +2,7 @@
 sidebar_position: 2
 ---
 
-import {SwaggerDoc} from '../../../../src/components/swagger-doc/SwaggerDoc';
+import {SwaggerDoc} from '../../../src/components/swagger-doc/SwaggerDoc';
 
 # Driver API
 

…s/cow-protocol/reference/apis/driver.mdx docs/cow-protocol/apis/driver.mdxdocs/cow-protocol/reference/apis/driver.mdx renamed to docs/cow-protocol/apis/driver.mdx docs/cow-protocol/reference/apis/driver.mdx renamed to docs/cow-protocol/apis/driver.mdx

@@ -2,7 +2,7 @@
 sidebar_position: 1
 ---
 
-import {SwaggerDoc} from '../../../../src/components/swagger-doc/SwaggerDoc';
+import {SwaggerDoc} from '../../../src/components/swagger-doc/SwaggerDoc';
 
 # Order book API
 

…ow-protocol/reference/apis/orderbook.mdx docs/cow-protocol/apis/orderbook.mdxdocs/cow-protocol/reference/apis/orderbook.mdx renamed to docs/cow-protocol/apis/orderbook.mdx docs/cow-protocol/reference/apis/orderbook.mdx renamed to docs/cow-protocol/apis/orderbook.mdx

@@ -2,7 +2,7 @@
 sidebar_position: 3
 ---
 
-import {SwaggerDoc} from '../../../../src/components/swagger-doc/SwaggerDoc';
+import {SwaggerDoc} from '../../../src/components/swagger-doc/SwaggerDoc';
 
 # Solver API
 

…s/cow-protocol/reference/apis/solver.mdx docs/cow-protocol/apis/solver.mdxdocs/cow-protocol/reference/apis/solver.mdx renamed to docs/cow-protocol/apis/solver.mdx docs/cow-protocol/reference/apis/solver.mdx renamed to docs/cow-protocol/apis/solver.mdx

@@ -4,7 +4,7 @@ sidebar_position: 2
 
 # How to specify an order with flash loan
 
-The flash loan is encoded into the [appData](/cow-protocol/reference/core/intents/app-data)'s metadata as an optional object. This information serves as a hint for the solver, but the solver ultimately can decide for a different approach in order to make the operation more optimal.
+The flash loan is encoded into the [appData](/cow-protocol/reference/intents/app-data)'s metadata as an optional object. This information serves as a hint for the solver, but the solver ultimately can decide for a different approach in order to make the operation more optimal.
 
 It is important to ensure that the flash loan gas overhead is added to the slippage tolerance when creating the order.
 

docs/cow-protocol/concepts/flash-loans/integrators.md

@@ -28,7 +28,7 @@ Solvers not only scan all available on-chain liquidity (similar to a DEX aggrega
 The intent-based architecture of CoW Protocol also provides a number of technical benefits: 
 
 - Enabling [solvers](./solvers) to execute all sorts of transactions (not just trades) based on specific instructions and on-chain conditions. This powers products like [CoW Hooks](../order-types/cow-hooks) and [Programmatic Orders](../order-types/programmatic-orders)
-- Establishing additional rules for the way orders settle on-chain, such as guaranteeing that the trade is settled at [EBBO](/cow-protocol/reference/core/definitions#ebbo) (Ethereum best bid and offer, guaranteeing that the baseline price for the trade is what on-chain AMMs offer) and uniform clearing prices (where trades with the same token pair in the same batch are cleared at the same price)
+- Establishing additional rules for the way orders settle on-chain, such as guaranteeing that the trade is settled at [EBBO](/cow-protocol/reference/definitions#ebbo) (Ethereum best bid and offer, guaranteeing that the baseline price for the trade is what on-chain AMMs offer) and uniform clearing prices (where trades with the same token pair in the same batch are cleared at the same price)
 - Allowing users to pay gas fees in their *sell token* without needing to hold the chain-native token (like ETH) in their wallet
 - Eliminating fees for failed transactions
 - Allowing users to place multiple orders at once