feat: restructure docs

Author: anxolin

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

docs/cow-protocol/concepts/introduction/intents.md

@@ -11,15 +11,15 @@ CoW Protocol delivers optimal price outcomes by leveraging an open solver compet
 Solvers are bonded third parties that execute trades on behalf of users through an [intent-based delegated execution model](intents). 
 
 Once a user submits an [intent](intents), the protocol groups it alongside other intents in a batch auction.
-As soon as a batch is "closed for orders", meaning that it stops considering new orders, the protocol runs a [competition](/cow-protocol/reference/core/auctions) where solvers submit solutions for the intents in the batch. 
+As soon as a batch is "closed for orders", meaning that it stops considering new orders, the protocol runs a [competition](/cow-protocol/reference/auctions) where solvers submit solutions for the intents in the batch. 
 
-Whichever solver offers the best [solution](/cow-protocol/reference/core/auctions/the-problem#solution) for the batch auction (defined as the solver that provides the most surplus to user orders) gets to execute the orders.
+Whichever solver offers the best [solution](/cow-protocol/reference/auctions/the-problem#solution) for the batch auction (defined as the solver that provides the most surplus to user orders) gets to execute the orders.
 
 Solvers are compensated in COW tokens for settling batches, incentivizing them to compete to find better prices and win the right to execute user intents. 
 
 ## How Solvers Work
 
-Solvers can move tokens on behalf of the user using the `ERC-20` approvals that the user granted to the [vault relayer](/cow-protocol/reference/contracts/core/vault-relayer) contract.
-The [settlement](/cow-protocol/reference/contracts/core/settlement) contract, meanwhile, verifies the signature of the user's intent and ensures that execution happens according to the limit price and quantity specified by the user.
+Solvers can move tokens on behalf of the user using the `ERC-20` approvals that the user granted to the [vault relayer](/cow-protocol/contracts/core/vault-relayer) contract.
+The [settlement](/cow-protocol/contracts/core/settlement) contract, meanwhile, verifies the signature of the user's intent and ensures that execution happens according to the limit price and quantity specified by the user.
 
 Anyone with some DeFi knowledge and ability to code an optimizations algorithm can create a solver.