Improve titles and order of Features

spiceaidocs/docs/features/ai-gateway/index.md

@@ -0,0 +1,25 @@
+---
+title: 'AI Gateway - Configuring LLMs'
+sidebar_label: 'AI Gateway'
+description: 'Learn how to configure language models and use Spice as an AI Gateway.'
+sidebar_position: 5
+pagination_prev: null
+pagination_next: null
+---
+
+Spice provides a high-performance, OpenAI API-compatible AI Gateway optimized for managing and scaling large language models (LLMs).
+
+Additionally, Spice offers tools for Enterprise Retrieval-Augmented Generation (RAG), such as SQL query across federated datasets and an advanced search feature (see [Search](/features/search)).
+
+Spice also supports **full OpenTelemetry observability**, enabling detailed tracking of data flows and requests for full transparency and easier debugging.
+
+## Configuring Language Models
+
+Spice supports a variety of LLMs (see [Model Components](/components/models/index.md)).
+
+### Core Features
+
+- **Custom Tools**: Equip models with tools to interact with the Spice runtime.
+- **System Prompts**: Customize system prompts and override defaults for [`v1/chat/completion`](/api/http/chat-completions.md).
+
+For detailed configuration and API usage, refer to the [API Documentation](/api/overview.md).

spiceaidocs/docs/features/caching/index.md

@@ -2,7 +2,7 @@
 title: 'Results Caching'
 sidebar_label: 'Results Caching'
 description: 'Learn how to use Spice in-memory caching of query results'
-sidebar_position: 5
+sidebar_position: 3
 pagination_prev: null
 pagination_next: null
 ---

spiceaidocs/docs/features/cdc/index.md

@@ -2,7 +2,7 @@
 title: 'Change Data Capture (CDC)'
 sidebar_label: 'Change Data Capture'
 description: 'Learn how to use Change Data Capture (CDC) in Spice.'
-sidebar_position: 6
+sidebar_position: 4
 pagination_prev: null
 pagination_next: null
 ---

spiceaidocs/docs/features/local-acceleration/index.md → spiceaidocs/docs/features/data-acceleration/index.md

@@ -1,8 +1,8 @@
 ---
-title: 'Local Acceleration'
-sidebar_label: 'Local Acceleration'
-description: 'Learn how to use local acceleration in Spice.'
-sidebar_position: 3
+title: 'Data Acceleration'
+sidebar_label: 'Data Acceleration'
+description: 'Learn how to use local data acceleration in Spice.'
+sidebar_position: 2
 pagination_prev: null
 ---
 

spiceaidocs/docs/features/data-ingestion/index.md

@@ -2,12 +2,11 @@
 title: 'Data Ingestion'
 sidebar_label: 'Data Ingestion'
 description: 'Learn how to ingest data in Spice.'
-sidebar_position: 4
+sidebar_position: 7
 pagination_prev: null
 pagination_next: null
 ---
 
-
 Data can be ingested by the Spice runtime for replication to a Data Connector, like PostgreSQL or the Spice.ai Cloud platform.
 
 By default, the runtime exposes an [OpenTelemety](https://opentelemetry.io) (OTEL) endpoint at grpc://127.0.0.1:50052 for data ingestion.
@@ -63,4 +62,4 @@ SMART data will be available in the `smart_attribute_raw_value` dataset in Spice
 
 - Only Spice.ai replication is supported for now.
 
-:::
+:::

spiceaidocs/docs/features/federated-queries/index.md

@@ -2,7 +2,7 @@
 title: 'Federated Queries'
 sidebar_label: 'Federated Queries'
 description: 'Learn how to use federated queries in Spice.'
-sidebar_position: 2
+sidebar_position: 1
 pagination_prev: null
 pagination_next: null
 ---

spiceaidocs/docs/features/search/index.md

@@ -2,7 +2,7 @@
 title: 'Search Functionality'
 sidebar_label: 'Search'
 description: 'Learn how Spice can search across datasets using database-native and vector-search methods.'
-sidebar_position: 8
+sidebar_position: 6
 pagination_prev: null
 pagination_next: null
 ---

spiceaidocs/docs/reference/sql/select.md

@@ -1,6 +1,6 @@
 ---
-title: "SELECT"
-sidebar_label: "SELECT"
+title: 'SELECT'
+sidebar_label: 'SELECT'
 pagination_prev: 'reference/sql/index'
 pagination_next: null
 sidebar_position: 1
@@ -27,7 +27,7 @@ Spice supports the following syntax for queries:
 [ [UNION](#union-clause) [ ALL | select ]  
 [ [ORDER BY](#order-by-clause) expression \[ ASC | DESC \][, ...] ]  
 [ [LIMIT](#limit-clause) count ]  
-[ [EXCLUDE | EXCEPT](#exclude-and-except-clause) ]  
+[ [EXCLUDE | EXCEPT](#exclude-and-except-clause) ]
 
 ### WITH clause
 
@@ -40,8 +40,8 @@ SELECT a, b FROM x;
 
 ### SELECT clause
 
-The `SELECT` clause is used to select data from a database by defining the colummns it returns.  Each `select_expr` in the
- SELECT list can be an expression or wildcards.
+The `SELECT` clause is used to select data from a database by defining the colummns it returns. Each `select_expr` in the
+SELECT list can be an expression or wildcards.
 
 Example:
 
@@ -68,7 +68,7 @@ SELECT t.a FROM table AS t
 
 ### WHERE clause
 
-The `WHERE` clause is used define the conditions to filter the query results.  
+The `WHERE` clause is used define the conditions to filter the query results.
 
 Example:
 
@@ -178,10 +178,10 @@ select * from x cross join x y;
 
 ### GROUP BY clause
 
-The `GROUP BY` clause groups together input rows that have the same value into summary rows.  
+The `GROUP BY` clause groups together input rows that have the same value into summary rows.
 
 `GROUP BY` is typically used with aggregrate functions (`COUNT()`, `MAX()`, `SUM()`), but if no aggregate functions are
- included, the query with a `GROUP BY` clause is the same as `SELECT DISTINCT`.
+included, the query with a `GROUP BY` clause is the same as `SELECT DISTINCT`.
 
 Example:
 
@@ -210,8 +210,8 @@ SELECT a, b, MAX(c) FROM table GROUP BY a, b HAVING MAX(c) > 10
 
 ### UNION clause
 
-The `UNION` clause combines the results of two or more `SELECT` statments.  By default `UNION` removes
- duplicates.  To include duplicates, use `UNION ALL`.
+The `UNION` clause combines the results of two or more `SELECT` statments. By default `UNION` removes
+duplicates. To include duplicates, use `UNION ALL`.
 
 Example: