Add comprehensive introductory content to CLI and API reference pages

content/influxdb3/core/reference/api/_index.md

@@ -1,10 +1,10 @@
 ---
 title: InfluxDB HTTP API
 description: >
-  The InfluxDB HTTP API for {{% product-name %}} provides a programmatic interface
-  for interactions with InfluxDB,
-  including writing, querying, and processing data, and managing an InfluxDB 3
-  instance.
+  The InfluxDB HTTP API provides a comprehensive programmatic interface for all 
+  interactions with InfluxDB 3 Core, including writing and querying time series data,
+  triggering Processing engine plugins, and managing your InfluxDB instance.
+  The API includes endpoints for backward compatibility with InfluxDB v1 and v2 workloads.
 menu:
   influxdb3_core:
     parent: Reference

content/influxdb3/core/reference/cli/_index.md

@@ -1,14 +1,28 @@
 ---
 title: Command line tools
 description: >
-  View command line tools used to manage and interact with InfluxDB 3 Core.
+  InfluxDB 3 Core provides powerful command line tools for database
+  administration, data management, and system operations. These CLI tools enable
+  you to efficiently manage your InfluxDB instance, write and query data, and
+  perform administrative tasks from the command line.
 menu:
   influxdb3_core:
     name: CLIs
     parent: Reference
 weight: 101
 ---
 
-View command line tools used to run, manage, and interact with InfluxDB 3 Core:
+InfluxDB 3 Core provides powerful command line tools for database administration, data management, and system operations.
+These CLI tools enable you to efficiently manage your InfluxDB instance, write and query data, and perform administrative tasks from the command line.
+
+The command line interface offers a streamlined way to:
+
+- Start and configure your InfluxDB 3 Core instance
+- Create and manage databases and tables
+- Write and query time series data
+- Perform system administration tasks
+- Automate database operations in scripts and workflows
+
+The following command line tools are available for InfluxDB 3 Core:
 
 {{< children >}}

content/influxdb3/enterprise/reference/api/_index.md

@@ -1,10 +1,10 @@
 ---
 title: InfluxDB HTTP API
 description: >
-  The InfluxDB HTTP API for {{% product-name %}} provides a programmatic interface
-  for interactions with InfluxDB,
-  including writing, querying, and processing data, and managing an InfluxDB 3
-  instance.
+  The InfluxDB HTTP API provides a comprehensive programmatic interface for all 
+  interactions with InfluxDB 3 Enterprise, including writing and querying time series data,
+  triggering Processing engine plugins, and managing your InfluxDB instance.
+  The API includes endpoints for backward compatibility with InfluxDB v1 and v2 workloads.
 menu:
   influxdb3_enterprise:
     parent: Reference

content/influxdb3/enterprise/reference/cli/_index.md

@@ -1,14 +1,28 @@
 ---
 title: Command line tools
 description: >
-  View command line tools used to manage and interact with InfluxDB 3 Enterprise.
+  InfluxDB 3 Enterprise provides powerful command line tools for database
+  administration, data management, and system operations. These CLI tools enable
+  you to efficiently manage your InfluxDB Enterprise instance, write and query data,
+  and perform administrative tasks from the command line.
 menu:
   influxdb3_enterprise:
     name: CLIs
     parent: Reference
 weight: 101
 ---
 
-View command line tools used to run, manage, and interact with InfluxDB 3 Enterprise:
+InfluxDB 3 Enterprise provides powerful command line tools for database administration, data management, and system operations.
+These CLI tools enable you to efficiently manage your InfluxDB Enterprise instance, write and query data, and perform administrative tasks from the command line.
+
+The command line interface offers a streamlined way to:
+
+- Start and configure your InfluxDB 3 Enterprise instance
+- Create and manage databases and tables
+- Write and query time series data
+- Perform system administration tasks
+- Automate database operations in scripts and workflows
+
+The following command line tools are available for InfluxDB 3 Enterprise:
 
 {{< children >}}

content/shared/influxdb3-api-reference/_index.md

@@ -1,7 +1,18 @@
-The InfluxDB HTTP API provides a programmatic interface for interactions with
-{{% product-name %}}, such as writing and querying data, triggering Processing
-engine plugins, and managing an InfluxDB 3 instance.
-The API includes endpoints for backward compatibility with
-InfluxDB v1 and v2 workloads, clients, and third-party tools.
+The InfluxDB HTTP API provides a comprehensive programmatic interface for all interactions with
+{{% product-name %}}, including writing and querying time series data, triggering Processing
+engine plugins, and managing your InfluxDB 3 instance.
+
+The API is designed for flexibility and performance, offering multiple endpoints to accommodate
+different use cases and client library requirements.
+Whether you're building real-time monitoring applications, data analytics pipelines, or custom
+integrations, the InfluxDB HTTP API provides the tools you need.
+
+The API includes endpoints for:
+
+- **Data operations**: Write time series data, execute SQL and InfluxQL queries
+- **Database management**: Create and manage databases, tables, and schemas
+- **Authentication and authorization**: Manage API tokens and access controls
+- **System administration**: Monitor system health and performance metrics
+- **Backward compatibility**: Support for InfluxDB v1 and v2 workloads, clients, and third-party tools
 
 <a class="btn" href="/influxdb3/{{% product-key %}}/api/v3/">{{% product-name %}} HTTP API</a>