Add the connect to warehouse doc

Signed-off-by: popcorny <[email protected]>

Author: popcornylu

docs/2-getting-started/start-free-with-cloud.md

@@ -86,16 +86,19 @@ Go beyond metadata to see how changes affect your actual data. Configure your da
 ### Supported Warehouses
 
 - Snowflake
-- others are on upcoming future
+- Databricks
+- Others coming in future releases
 
 ### Warehouse Connection
 
-Configure connection to your data warehouse to enable query result comparisons.
+Configure connection to your data warehouse to enable query result comparisons. For detailed connection settings, see [Connect to Warehouse](../5-data-diffing/connect-to-warehouse.md).
 
 **Connection setup:**
 
 1. Navigate to [settings](https://cloud.reccehq.com/settings#organization){target="_blank"}
 2. Add Connection
+3. Navigate to your [project home](https://cloud.datarecce.io/) and open the project settings by clicking the gear icon
+4. Link the newly added connection to your project
 
 Your connection credentials are secure. See our [security practices](https://reccehq.com/security/){target="_blank"} for details.
 

docs/5-data-diffing/connect-to-warehouse.md

@@ -0,0 +1,39 @@
+---
+title: Connect to Warehouse
+---
+
+## Recce OSS
+If you use the open source setup, you can connect to your warehouse the same way as dbt. No additional settings need to be configured. Recce uses the dbt library with your profiles to connect to your warehouse.
+
+
+## Recce Cloud
+If you use Recce Cloud, here are the warehouse connection settings. We currently support:
+
+- Snowflake
+- Databricks
+
+
+### Snowflake
+We only support password-based authentication.
+
+Field | Description | Examples
+----|------|----
+`account` | The Snowflake account to connect to | `xxxxxx.us-central1.gcp`
+`database` | The default database to connect to | `MYDB`
+`schema` | The default schema to connect to | `PUBLIC`
+`warehouse` | The warehouse to use when running queries | `WH_LOAD`
+`user` | The user to log in as | `MYUSER`
+`password` | The password for the user | `MYPASS`
+
+
+### Databricks
+
+We only support token-based authentication.
+
+Field | Description | Examples
+----|------|----
+`host` | The hostname of your cluster | `YOURORG.databrickshost.com`
+`http_path` | The HTTP path to your SQL Warehouse or all-purpose cluster | `/SQL/YOUR/HTTP/PATH`
+`catalog` | The catalog used to connect to the warehouse. This is optional if you are using Unity Catalog | `MY_CATALOG`
+`schema` | The default schema to connect to | `MY_SCHEMA`
+`token` | The Personal Access Token (PAT) to connect to Databricks | `dapiXXXXXXXXXXXXXXXXXXXXXXX`

docs/styles/extra.css

@@ -39,6 +39,10 @@
 	font-weight: bold;
 } */
 
+.md-nav__item--section>.md-nav__link {
+	color: #000 !important;
+}
+
 .md-nav__link[href]:hover {
 	color: #ff6e42;
 }

mkdocs.yml

@@ -63,6 +63,7 @@ nav:
           - 4-downstream-impacts/breaking-change-analysis.md
           #- 4-downstream-impacts/transformation-types.md
       - Data Diffing:
+          - 5-data-diffing/connect-to-warehouse.md
           - 5-data-diffing/row-count-diff.md
           - 5-data-diffing/profile-diff.md
           - 5-data-diffing/value-diff.md