refine Dot integration documentation for ClickHouse, enhancing clarity and updating content to reflect new features and capabilities

Author: publikphigor

docs/integrations/data-visualization/dot-and-clickhouse.md

@@ -9,89 +9,75 @@ title: 'Dot'
 import Image from '@theme/IdealImage';
 import dot_01 from '@site/static/images/integrations/data-visualization/dot_01.png';
 import dot_02 from '@site/static/images/integrations/data-visualization/dot_02.png';
-import dot_03 from '@site/static/images/integrations/data-visualization/dot_03.png';
 import CommunityMaintainedBadge from '@theme/badges/CommunityMaintained';
 
 # Dot
 
 <CommunityMaintainedBadge/>
 
-[Dot](https://www.getdot.ai/) is an intelligent **AI Data Analyst**. It connects directly to ClickHouse so you can ask business questions in plain English, discover data assets, validate definitions, and even assist with modelling — all through a conversational interface.
+[Dot](https://www.getdot.ai/) is your **AI Data Analyst**. It connects directly to ClickHouse so you can ask data questions in natural language, discover data, test hypotheses, and answer why questions — directly in Slack, Microsoft Teams, ChatGPT or the native Web UI.
+
+---
+
+## Pre-requisites {#pre-requisites}
+
+- A ClickHouse database, either self-hosted or in [ClickHouse Cloud](https://clickhouse.com/cloud)  
+- A [Dot](https://www.getdot.ai/) account  
+- A [Hashboard](https://www.hashboard.com/) account and project.  
 
 ---
 
 ## Connecting Dot to ClickHouse {#connecting-dot-to-clickhouse}
 
-<Image size="md" img={dot_01} alt="Configuring ClickHouse connection in Dot" border />
+<Image size="md" img={dot_01} alt="Configuring ClickHouse connection in Dot (light mode)" border />
 <br/>
 
 1. In the Dot UI, go to **Settings → Connections**.  
-2. Click on ***Add new connection*** and select **ClickHouse** as your data source.  
-3. Enter the connection details:  
+2. Click on **Add new connection** and select **ClickHouse**.  
+3. Provide your connection details:  
    - **Host**: ClickHouse server hostname or ClickHouse Cloud endpoint  
    - **Port**: `9440` (secure native interface) or `9000` (default TCP)  
-   - **Username / Password**: a user with read access to your data  
+   - **Username / Password**: user with read access  
    - **Database**: optionally set a default schema  
 4. Click **Connect**.
 
-<div style={{display: 'flex', gap: '20px'}}>
-  <Image img={dot_02} alt="Dot generating SQL against ClickHouse" />
-  <Image img={dot_03} alt="Browsing ClickHouse schemas and definitions in Dot" />
+<div style={{maxWidth: '500px', marginInline: 'auto'}}>
+   <Image img={dot_02} alt="Connecting ClickHouse" />
 </div>
 <br/>
 
----
-
-## Querying Data with Dot {#querying-data-with-dot}
-
-Once connected, Dot translates natural language questions into SQL queries against your ClickHouse instance. Examples:
-
-- *“What are the top 10 most active users in the last 7 days?”*  
-- *“Show me daily revenue trends over the past 3 months.”*  
-- *“How many new signups came from Germany last week?”*  
-
-
-Dot allows you to preview and edit the generated SQL before execution, ensuring accuracy and transparency.
+Dot uses **query-pushdown**: ClickHouse handles the heavy number-crunching at scale, while Dot ensures correct and trusted answers.
 
 ---
 
-## Data Discovery and Definitions {#data-discovery}
-
-Dot isn’t just for queries — it helps with **schema exploration** and **data governance**:
-
-- Browse databases, tables, and columns directly from ClickHouse  
-- See column definitions and data types  
-- Retrieve metric definitions and contextual metadata  
-- Understand how fields are used across queries and dashboards  
+## Highlights {#highlights}
 
+Dot makes data accessible through conversation:
 
-This makes self-service easier for analysts and business users, while keeping data teams in control.
+- **Ask in natural language**: Get answers without writing SQL.  
+- **Why analysis**: Ask follow-up questions to understand trends and anomalies.  
+- **Works where you work**: Slack, Microsoft Teams, ChatGPT, or the web app.  
+- **Trusted results**: Dot validates queries against your schemas and definitions to minimize errors.  
+- **Scalable**: Built on query-pushdown, pairing Dot’s intelligence with ClickHouse’s speed.  
 
 ---
 
 ## Security and Governance {#security}
 
-Dot is designed with enterprise readiness in mind:
+Dot is enterprise-ready:
 
-- **Permissions & roles**: Dot respects ClickHouse’s native user roles and access controls  
-- **Row-level security**: Supported where configured in ClickHouse  
-- **TLS / SSL**: For ClickHouse Cloud, SSL is enabled by default; for on-premise, enable TLS manually  
-- **Governance & validation**: Dot includes a training/validation space to reduce errors and keep data teams in control  
-- **Compliance**: Dot is SOC 2 Type I certified  
+- **Permissions & roles**: Inherits ClickHouse user access controls  
+- **Row-level security**: Supported if configured in ClickHouse  
+- **TLS / SSL**: Enabled by default for ClickHouse Cloud; configure manually for self-hosted  
+- **Governance & validation**: Training/validation space helps prevent hallucinations  
+- **Compliance**: SOC 2 Type I certified  
 
 ---
 
-## Supported Integrations Beyond ClickHouse {#integrations}
+## Additional Resources {#additional-resources}
 
-In addition to ClickHouse, Dot also integrates with:
-
-- Data warehouses: Snowflake, BigQuery, Redshift, Databricks, AWS Athena, PostgreSQL, MySQL, SAP HANA, Motherduck/DuckDB  
-- Semantic layers: dbt Semantic Layer, Looker  
-- BI tools: Tableau, Metabase  
-- Communication: Slack, Microsoft Teams  
-
-This makes Dot a versatile layer on top of your modern data stack.
-
----
+- Dot website: [https://www.getdot.ai/](https://www.getdot.ai/)  
+- Documentation: [https://docs.getdot.ai/](https://docs.getdot.ai/)  
+- Dot app: [https://app.getdot.ai/](https://app.getdot.ai/)  
 
-Now you can use **ClickHouse + Dot** to explore, validate, and analyze your data conversationally — combining high-performance analytics with AI-driven accessibility.
+Now you can use **ClickHouse + Dot** to analyze your data conversationally — combining Dot’s AI assistant with ClickHouse’s fast, scalable analytics engine.