docs: update routes to use table

Signed-off-by: Gustavo Inacio <[email protected]>

Author: gusinacio

docs/Routes.md

@@ -1,19 +1,45 @@
 # Routes
 
-Current routes exposed by Subgraph Service:
-- `/`: greetings message
-- `/info`: the operator public address
-- `/version`: current indexer-service-rs version and dependencies
-- `/escrow` *(token required)*: quick endpoint that routes 
-queries to escrow subgraph.
-- `/network` *(token required)*: quick endpoint that routes 
-queries to network subgraph.
-- `/dips`: Dips GraphQL API
-- `/subgraph/health/:id`: get health state for a given subgraph
-- `/subgraphs/id/:id` *(receipt/token required)*: Route a query 
-to a subgraph
-- `/cost`: Cost Model GraphQL API
-- `/status`: Routes graph-node status API
-
-In case this documentation is outdated, you can check a list of 
-all routes in the [end of this file](./crates/service/src/service/router.rs).
+This section lists the routes currently exposed by the Subgraph Service. Each route includes a brief description of its purpose and any requirements (e.g., tokens) for access.
+
+## Public Routes
+
+| Route                   | Description                                                                                  |
+|-------------------------|----------------------------------------------------------------------------------------------|
+| `/`                     | Returns a simple greetings message.                                                         |
+| `/info`                 | Displays the operator's public address.                                                     |
+| `/version`              | Provides the current version of `indexer-service-rs` and its dependencies.                  |
+
+## Token-Protected Routes
+
+| Route                   | Description                                                                                  |
+|-------------------------|----------------------------------------------------------------------------------------------|
+| `/escrow`               | Routes queries to the escrow subgraph. Requires a valid token.                               |
+| `/network`              | Routes queries to the network subgraph. Requires a valid token.                              |
+
+## GraphQL API Routes
+
+| Route                   | Description                                                                                  |
+|-------------------------|----------------------------------------------------------------------------------------------|
+| `/dips`                 | Provides access to the Dips GraphQL API.                                                     |
+| `/cost`                 | Provides access to the Cost Model GraphQL API.                                               |
+
+## Subgraph Routes
+
+| Route                                | Description                                                                                  |
+|--------------------------------------|----------------------------------------------------------------------------------------------|
+| `/subgraph/health/:id`               | Retrieves the health state of a specified subgraph using its ID.                             |
+| `/subgraphs/id/:id`                  | Routes a query to a specific subgraph using its ID. Requires a receipt or valid token.       |
+
+## Node Status Route
+
+| Route                   | Description                                                                                  |
+|-------------------------|----------------------------------------------------------------------------------------------|
+| `/status`               | Routes requests to the graph-node status API.                                                |
+
+---
+
+## Note
+
+If this documentation is outdated or incomplete, you can view the complete and up-to-date list of routes in the source code:  
+[Service Router Implementation](./crates/service/src/service/router.rs)