diff --git a/docs/_snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx b/docs/_snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx
deleted file mode 100644
index 121020434..000000000
--- a/docs/_snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx
+++ /dev/null
@@ -1,23 +0,0 @@
-### Data warehouses
-
-
-
-### Transformation and orchestration
-
-
-
-### Data visualization
-
-
-
-### Reverse ETL
-
-
-
-### Code repositories
-
-
-
-### Alerts & incidents
-
-
\ No newline at end of file
diff --git a/docs/_snippets/dwh/bigquery/cli_service_account.mdx b/docs/_snippets/dwh/bigquery/cli_service_account.mdx
deleted file mode 100644
index 2d66aba18..000000000
--- a/docs/_snippets/dwh/bigquery/cli_service_account.mdx
+++ /dev/null
@@ -1,3 +0,0 @@
-
-
-
diff --git a/docs/_snippets/dwh/bigquery/cloud_service_account.mdx b/docs/_snippets/dwh/bigquery/cloud_service_account.mdx
deleted file mode 100644
index 703186db4..000000000
--- a/docs/_snippets/dwh/bigquery/cloud_service_account.mdx
+++ /dev/null
@@ -1,4 +0,0 @@
-
-
-
-
diff --git a/docs/_snippets/faq/question-schema.mdx b/docs/_snippets/faq/question-schema.mdx
deleted file mode 100644
index 5a80fc069..000000000
--- a/docs/_snippets/faq/question-schema.mdx
+++ /dev/null
@@ -1,5 +0,0 @@
-
-
-
-
-
diff --git a/docs/cloud/features.mdx b/docs/cloud/features.mdx
index 4a27276bb..ae375317f 100644
--- a/docs/cloud/features.mdx
+++ b/docs/cloud/features.mdx
@@ -3,4 +3,8 @@ title: "Platform features"
icon: "browsers"
---
-
\ No newline at end of file
+import Features from '/snippets/cloud/features.mdx';
+
+
+
+
\ No newline at end of file
diff --git a/docs/cloud/features/alerts-and-incidents/alert-rules.mdx b/docs/cloud/features/alerts-and-incidents/alert-rules.mdx
index 6ecd26666..70daab05b 100644
--- a/docs/cloud/features/alerts-and-incidents/alert-rules.mdx
+++ b/docs/cloud/features/alerts-and-incidents/alert-rules.mdx
@@ -2,7 +2,11 @@
title: "Alert rules"
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
**Alert Rules** help you control where alerts are sent and when they are triggered, so you can stay focused on the incidents that matter most. In Elementary Cloud, each rule combines **filters** (what to alert on) and **destinations** (where to send the alert).
diff --git a/docs/cloud/features/alerts-and-incidents/alerts-and-incidents-overview.mdx b/docs/cloud/features/alerts-and-incidents/alerts-and-incidents-overview.mdx
index 41e3eec25..5bfbc9b60 100644
--- a/docs/cloud/features/alerts-and-incidents/alerts-and-incidents-overview.mdx
+++ b/docs/cloud/features/alerts-and-incidents/alerts-and-incidents-overview.mdx
@@ -3,6 +3,11 @@ title: Alerts and Incidents Overview
sidebarTitle: Alerts & incidents overview
---
+import AlertTypes from '/snippets/cloud/features/alerts-and-incidents/alert-types.mdx';
+import AlertsDestinationCards from '/snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx';
+
+
+
Alerts and incidents in Elementary are designed to shorten your time to response and time to resolution when data issues occur.
- **Alert -** Notification about an event that indicates a data issue.
@@ -51,8 +56,8 @@ you will be able to track all open and historical incidents, and get metrics on
## Alert types
-
+
## Supported alert integrations
-
+
diff --git a/docs/cloud/features/alerts-and-incidents/incident-management.mdx b/docs/cloud/features/alerts-and-incidents/incident-management.mdx
index e85a80c2d..4b1b69d0d 100644
--- a/docs/cloud/features/alerts-and-incidents/incident-management.mdx
+++ b/docs/cloud/features/alerts-and-incidents/incident-management.mdx
@@ -3,7 +3,11 @@ title: Incident Management
sidebarTitle: Incident management
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
The `Incidents` page is designed to enable your team to stay on top of open incidents and collaborate on resolving them.
The page gives a comprehensive overview of all current and previous incidents, where users can view the status, prioritize, assign and resolve incidents.
diff --git a/docs/cloud/features/alerts-and-incidents/incidents.mdx b/docs/cloud/features/alerts-and-incidents/incidents.mdx
index 10809c345..d11752de6 100644
--- a/docs/cloud/features/alerts-and-incidents/incidents.mdx
+++ b/docs/cloud/features/alerts-and-incidents/incidents.mdx
@@ -3,7 +3,11 @@ title: Incidents in Elementary
sidebarTitle: Incidents
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
One of the challenges data teams face is tracking and understand and collaborate on the status of data issues.
Tests fail daily, pipelines are executed frequently, alerts are sent to different channels.
diff --git a/docs/cloud/features/alerts-and-incidents/owners-and-subscribers.mdx b/docs/cloud/features/alerts-and-incidents/owners-and-subscribers.mdx
index 362615eea..4486f302c 100644
--- a/docs/cloud/features/alerts-and-incidents/owners-and-subscribers.mdx
+++ b/docs/cloud/features/alerts-and-incidents/owners-and-subscribers.mdx
@@ -2,6 +2,11 @@
title: "Owners and subscribers"
---
+import Owner from '/snippets/alerts/owner.mdx';
+import Subscribers from '/snippets/alerts/subscribers.mdx';
+
+
+
We highly recommend configuring owners and subscribers for your models and/or tests.
An owner is the person responsible for the model, and subscribers are the people who are interested in getting the alerts on the model or test.
Owners and subscribers will be mentioned (tagged) in the Slack alerts. Also their name will appear in the alerts and the UI.
@@ -12,8 +17,8 @@ configuring owners and subscribers:
Owners can be easily added or edited in the Catalog screen. [Learn more about managing your assets' metadata.](/cloud/features/data-governance/manage-metadata)
#### Configuting owners in code:
-
+
### Subscribers
-
+
diff --git a/docs/cloud/features/anomaly-detection/automated-freshness.mdx b/docs/cloud/features/anomaly-detection/automated-freshness.mdx
index 8b0357e0e..c86e0f77a 100644
--- a/docs/cloud/features/anomaly-detection/automated-freshness.mdx
+++ b/docs/cloud/features/anomaly-detection/automated-freshness.mdx
@@ -3,6 +3,11 @@ title: Automated Freshness Monitor
sidebarTitle: "Automated freshness"
---
+import FreshnessConfiguration from '/snippets/cloud/features/anomaly-detection/freshness-configuration.mdx';
+import AllAnomaliesConfiguration from '/snippets/cloud/features/anomaly-detection/all-anomalies-configuration.mdx';
+
+
+
The purpose of the Freshness monitor is to alert when a data asset hasn't been updated in a period of time that exceeds the update SLA of that table.
Freshness monitors are by default created for all sources in your dbt project. They can be created for additional tables upon request.
@@ -59,5 +64,5 @@ Use the `Anomaly settings` and `result feedback` buttons to impact the monitor.
### Anomaly settings
-
-
+
+
diff --git a/docs/cloud/features/anomaly-detection/automated-monitors.mdx b/docs/cloud/features/anomaly-detection/automated-monitors.mdx
index 428bce61d..588cbcd95 100644
--- a/docs/cloud/features/anomaly-detection/automated-monitors.mdx
+++ b/docs/cloud/features/anomaly-detection/automated-monitors.mdx
@@ -3,9 +3,15 @@ title: Automated Freshness & Volume Monitors
sidebarTitle: "Introduction"
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+import AutomatedMonitorsIntro from '/snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx';
+import AutomatedMonitorsCards from '/snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx';
-
+
+
+
+
+
Once your environment is set up, we automatically collect metadata from your warehouse, which our ML models run on.
The models are operational when the initial backfill is completed, there is no "loading / training period" - Elementary will collect enough historical data after setup to train the models.
@@ -36,7 +42,7 @@ You can fine tune the [configuration](/cloud/features/anomaly-detection/monitors
## Automated Monitors
-
+
## Alerts on Failures
diff --git a/docs/cloud/features/anomaly-detection/automated-volume.mdx b/docs/cloud/features/anomaly-detection/automated-volume.mdx
index 15b66da75..6e45c285a 100644
--- a/docs/cloud/features/anomaly-detection/automated-volume.mdx
+++ b/docs/cloud/features/anomaly-detection/automated-volume.mdx
@@ -3,6 +3,11 @@ title: Automated Volume Monitor
sidebarTitle: "Automated volume"
---
+import VolumeConfiguration from '/snippets/cloud/features/anomaly-detection/volume-configuration.mdx';
+import AllAnomaliesConfiguration from '/snippets/cloud/features/anomaly-detection/all-anomalies-configuration.mdx';
+
+
+
The volume monitor tracks the **total row count** of a table over time, rather than individual table updates.
This means that Elementary will not consider a single update as anomalous, but rather a continuous anomalous trend occurring over a period of time.
@@ -31,8 +36,8 @@ Use the `Anomaly settings` and `result feedback` buttons to impact the monitor.
### Anonmaly settings
-
-
+
+
+
#### Volume monitor
-
+
#### Freshness monitor
-
+
diff --git a/docs/cloud/features/anomaly-detection/monitors-overview.mdx b/docs/cloud/features/anomaly-detection/monitors-overview.mdx
index d0705bd86..60d3b5ab2 100644
--- a/docs/cloud/features/anomaly-detection/monitors-overview.mdx
+++ b/docs/cloud/features/anomaly-detection/monitors-overview.mdx
@@ -3,7 +3,13 @@ title: Anomaly Detection Monitors
sidebarTitle: "Monitors overview"
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+import AutomatedMonitorsIntro from '/snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx';
+import AutomatedMonitorsCards from '/snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx';
+
+
+
+
ML-powered anomaly detection monitors automatically identify outliers and unexpected patterns in your data.
These are useful to detect issues such as incomplete data, delays, a drop in a specific dimension or a spike in null values.
@@ -15,9 +21,9 @@ Elementary offers two types of monitors:
## [Automated monitors](/cloud/features/anomaly-detection/automated-monitors)
-
+
-
+
## Opt-in monitors
diff --git a/docs/cloud/features/ci.mdx b/docs/cloud/features/ci.mdx
index 236a35c5c..d20d5012a 100644
--- a/docs/cloud/features/ci.mdx
+++ b/docs/cloud/features/ci.mdx
@@ -3,7 +3,11 @@ title: "Elementary CI"
sidebarTitle: "Elementary CI"
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
### Closed beta - Elementary Pull request impact analysis!
diff --git a/docs/cloud/features/collaboration-and-communication/catalog.mdx b/docs/cloud/features/collaboration-and-communication/catalog.mdx
index b86f066fa..dbaed7826 100644
--- a/docs/cloud/features/collaboration-and-communication/catalog.mdx
+++ b/docs/cloud/features/collaboration-and-communication/catalog.mdx
@@ -2,7 +2,11 @@
title: "Data Catalog"
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
The Elementary Cloud catalog is a dynamic workspace for managing data assets. It combines your dbt models, sources, columns, tests, and metrics with metadata, test results, and ownership in one place.
diff --git a/docs/cloud/features/collaboration-and-communication/data-health.mdx b/docs/cloud/features/collaboration-and-communication/data-health.mdx
index d4bf6d5a0..4c91ae49c 100644
--- a/docs/cloud/features/collaboration-and-communication/data-health.mdx
+++ b/docs/cloud/features/collaboration-and-communication/data-health.mdx
@@ -3,9 +3,15 @@ title: Data Health Dashboard
sidebarTitle: Data Health Dashboard
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+import DataHealthIntro from '/snippets/cloud/features/data-health/data-health-intro.mdx';
+import DataQualityDimensions from '/snippets/cloud/features/data-health/data-quality-dimensions.mdx';
-
+
+
+
+
+
### Data Health Dashboard
@@ -19,7 +25,7 @@ Filters are available at the top of the page, making it easy to see the data hea
The dashboard is based on the 6 [Data Quality Dimensions](/cloud/features/collaboration-and-communication/data-quality-dimensions#data-quality-dimensions):
-
+
### How is the data health score calculated?
diff --git a/docs/cloud/features/collaboration-and-communication/data-quality-dimensions.mdx b/docs/cloud/features/collaboration-and-communication/data-quality-dimensions.mdx
index 7ac31e506..c31a723cd 100644
--- a/docs/cloud/features/collaboration-and-communication/data-quality-dimensions.mdx
+++ b/docs/cloud/features/collaboration-and-communication/data-quality-dimensions.mdx
@@ -3,16 +3,21 @@ title: Data Quality Dimensions
sidebarTitle: Data Quality Dimensions
---
+import DataHealthIntro from '/snippets/cloud/features/data-health/data-health-intro.mdx';
+import DataQualityDimensions from '/snippets/cloud/features/data-health/data-quality-dimensions.mdx';
+
+
+
## Measuring data quality
-
+
## Data quality dimensions
The 6 Data Quality Dimensions are:
-
+
## Data quality dimensions example
diff --git a/docs/cloud/features/data-lineage/column-level-lineage.mdx b/docs/cloud/features/data-lineage/column-level-lineage.mdx
index 7b8a7239e..b4821a339 100644
--- a/docs/cloud/features/data-lineage/column-level-lineage.mdx
+++ b/docs/cloud/features/data-lineage/column-level-lineage.mdx
@@ -3,7 +3,11 @@ title: Column-Level Lineage
sidebarTitle: Column level lineage
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
The table nodes in Elementary lineage can be expanded to show the columns. When you
select a column, the lineage of that specific column will be highlighted.
diff --git a/docs/cloud/features/data-lineage/exposures-lineage.mdx b/docs/cloud/features/data-lineage/exposures-lineage.mdx
index 634427c2d..a9b7f77e9 100644
--- a/docs/cloud/features/data-lineage/exposures-lineage.mdx
+++ b/docs/cloud/features/data-lineage/exposures-lineage.mdx
@@ -3,6 +3,11 @@ title: Lineage to Downstream Dashboards and Tools
sidebarTitle: Lineage to BI
---
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+import BiCards from '/snippets/cloud/integrations/cards-groups/bi-cards.mdx';
+
+
+
Some of your data is used downstream in dashboards, applications, data science pipelines, reverse ETLs, etc.
These downstream data consumers are called _exposures_.
@@ -43,7 +48,7 @@ exposures:
### Automated lineage to the BI
-
+
Elementary will automatically and continuously extend the column-level lineage to the dashboard level of your data visualization tool.
@@ -61,4 +66,4 @@ alt="Elementary Lineage"
### Supported BI tools:
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/cloud/features/data-lineage/lineage.mdx b/docs/cloud/features/data-lineage/lineage.mdx
index c30c2cb40..e345a59c8 100644
--- a/docs/cloud/features/data-lineage/lineage.mdx
+++ b/docs/cloud/features/data-lineage/lineage.mdx
@@ -3,7 +3,11 @@ title: End-to-End Data Lineage
sidebarTitle: Lineage overview
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
Elementary offers automated [Column-Level Lineage](/cloud/features/data-lineage/column-level-lineage) functionality, enriched with the latest test and monitors results.
It is built with usability and performance in mind.
diff --git a/docs/cloud/features/data-tests/data-tests-overview.mdx b/docs/cloud/features/data-tests/data-tests-overview.mdx
index 5184b4f72..81c33f540 100644
--- a/docs/cloud/features/data-tests/data-tests-overview.mdx
+++ b/docs/cloud/features/data-tests/data-tests-overview.mdx
@@ -3,6 +3,10 @@ title: Data Tests Overview
sidebarTitle: Overview and configuration
---
+import DataTestsCards from '/snippets/cloud/features/data-tests/data-tests-cards.mdx';
+
+
+
Data tests are useful for validating and enforcing explicit expectations on your data.
Elementary enables data validation and result tracking by leveraging dbt tests and dbt packages such as dbt-utils, dbt-expectations, and Elementary.
@@ -14,7 +18,7 @@ The combination of dbt tests, Elementary monitors, custom SQL tests and the rich
### Supported data tests
-
+
## Test configuration
diff --git a/docs/cloud/features/data-tests/dbt-tests.mdx b/docs/cloud/features/data-tests/dbt-tests.mdx
index 3fb27d027..00bcc258c 100644
--- a/docs/cloud/features/data-tests/dbt-tests.mdx
+++ b/docs/cloud/features/data-tests/dbt-tests.mdx
@@ -3,11 +3,17 @@ title: dbt, Packages and Elementary Tests
sidebarTitle: dbt tests
---
-
+import BenefitsDbtTests from '/snippets/cloud/features/data-tests/benefits-dbt-tests.mdx';
+import DbtTestHub from '/snippets/cloud/features/data-tests/dbt-test-hub.mdx';
+import TestsCards from '/snippets/data-tests/tests-cards.mdx';
+
+
+
+
### dbt Test Hub
-
+
### Supported dbt tests and packages
@@ -25,6 +31,6 @@ The following packages are supported in the tests configuration wizard:
The Elementary dbt package also provides tests for detection of data quality issues.
Elementary data tests are configured and executed like native tests in your dbt project.
-
+
diff --git a/docs/cloud/features/integrations.mdx b/docs/cloud/features/integrations.mdx
index cebec92a3..4bf43e3cf 100644
--- a/docs/cloud/features/integrations.mdx
+++ b/docs/cloud/features/integrations.mdx
@@ -4,4 +4,8 @@ sidebarTitle: "Integrations"
icon: "plug"
---
-
\ No newline at end of file
+import CloudIntegrationsCards from '/snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx';
+
+
+
+
\ No newline at end of file
diff --git a/docs/cloud/features/multi-env.mdx b/docs/cloud/features/multi-env.mdx
index 4fb533ac2..064ed2354 100644
--- a/docs/cloud/features/multi-env.mdx
+++ b/docs/cloud/features/multi-env.mdx
@@ -2,7 +2,11 @@
title: "Multiple Environments"
---
-
+import CloudFeatureTag from '/snippets/cloud/cloud-feature-tag.mdx';
+
+
+
+
An environment in Elementary is a combination of a dbt project and a target.
For example: If you have a single dbt project with three targets, prod, staging and dev, you can create 3 environments in Elementary and monitor these environments.
diff --git a/docs/cloud/general/security-and-privacy.mdx b/docs/cloud/general/security-and-privacy.mdx
index d4f72253f..c68e80074 100644
--- a/docs/cloud/general/security-and-privacy.mdx
+++ b/docs/cloud/general/security-and-privacy.mdx
@@ -4,6 +4,10 @@ sidebarTitle: "Security and privacy"
icon: "lock"
---
+import HowItWorks from '/snippets/cloud/how-it-works.mdx';
+
+
+
## Security highlights
Our product is designed with security and privacy in mind.
@@ -34,7 +38,7 @@ Our product and architecture are always evolving, but our commitment to secure d
## How it works?
-
+
## What information does Elementary collect?
diff --git a/docs/cloud/guides/alerts-configuration.mdx b/docs/cloud/guides/alerts-configuration.mdx
index b62328a00..77e0d4b69 100644
--- a/docs/cloud/guides/alerts-configuration.mdx
+++ b/docs/cloud/guides/alerts-configuration.mdx
@@ -2,4 +2,8 @@
title: "Alerts code configuration"
---
-
+import AlertsCodeConfiguration from '/snippets/guides/alerts-code-configuration.mdx';
+
+
+
+
diff --git a/docs/cloud/guides/collect-job-data.mdx b/docs/cloud/guides/collect-job-data.mdx
index cfd3749bc..c1c156f25 100644
--- a/docs/cloud/guides/collect-job-data.mdx
+++ b/docs/cloud/guides/collect-job-data.mdx
@@ -3,4 +3,8 @@ title: "Collect Jobs Info From Orchestrator"
sidebarTitle: "Collect jobs data"
---
-
+import CollectJobData from '/snippets/guides/collect-job-data.mdx';
+
+
+
+
diff --git a/docs/cloud/guides/collect-source-freshness.mdx b/docs/cloud/guides/collect-source-freshness.mdx
index 352a3bce1..977ca211e 100644
--- a/docs/cloud/guides/collect-source-freshness.mdx
+++ b/docs/cloud/guides/collect-source-freshness.mdx
@@ -3,7 +3,11 @@ title: "Collect dbt source freshness results"
sidebarTitle: "dbt source freshness"
---
-
+import DbtSourceFreshness from '/snippets/guides/dbt-source-freshness.mdx';
+
+
+
+
## Need help?
diff --git a/docs/cloud/guides/enable-slack-alerts.mdx b/docs/cloud/guides/enable-slack-alerts.mdx
index d2e97bcf1..770ebd465 100644
--- a/docs/cloud/guides/enable-slack-alerts.mdx
+++ b/docs/cloud/guides/enable-slack-alerts.mdx
@@ -2,10 +2,15 @@
title: "Enable alerts"
---
+import AlertsIntroduction from '/snippets/alerts/alerts-introduction.mdx';
+import AlertsDestinationCards from '/snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx';
+
+
+
## About alerts
-
+
## Alerts destinations
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/cloud/integrations/bi/connect-bi-tool.mdx b/docs/cloud/integrations/bi/connect-bi-tool.mdx
index 2900585ec..890b72dcc 100644
--- a/docs/cloud/integrations/bi/connect-bi-tool.mdx
+++ b/docs/cloud/integrations/bi/connect-bi-tool.mdx
@@ -3,6 +3,10 @@ title: "Automated lineage to Data Visualization layer"
sidebarTitle: "Automated BI lineage"
---
+import BiCards from '/snippets/cloud/integrations/cards-groups/bi-cards.mdx';
+
+
+
Elementary will automatically and continuously extend the column-level-lineage to the dashboard level of your data visualization tool.
This will provide you end-to-end data lineage to understand your downstream dependencies, called exposures.
@@ -26,7 +30,7 @@ alt="Elementary Lineage"
### Supported BI tools
-
+
### Automated dbt exposures.yml
diff --git a/docs/cloud/integrations/code-repo/bitbucket.mdx b/docs/cloud/integrations/code-repo/bitbucket.mdx
index b18a8fab4..d44d7d0fa 100644
--- a/docs/cloud/integrations/code-repo/bitbucket.mdx
+++ b/docs/cloud/integrations/code-repo/bitbucket.mdx
@@ -2,6 +2,10 @@
title: "Bitbucket"
---
+import RepoConnectionSettings from '/snippets/cloud/integrations/repo-connection-settings.mdx';
+
+
+
Elementary connects to the code repository where your dbt project code is managed, and opens PRs with configuration changes.
## Recommended: Connect using Elementary Bitbucket App
@@ -19,4 +23,4 @@ If connecting the Elementary Bitbucket App isn't an option, you can connect usin
## Repository connection settings
-
+
diff --git a/docs/cloud/integrations/code-repo/connect-code-repo.mdx b/docs/cloud/integrations/code-repo/connect-code-repo.mdx
index 92e1e089a..abde5898e 100644
--- a/docs/cloud/integrations/code-repo/connect-code-repo.mdx
+++ b/docs/cloud/integrations/code-repo/connect-code-repo.mdx
@@ -3,6 +3,10 @@ title: "Connect code repository"
sidebarTitle: "Code integration"
---
+import CodeRepoCards from '/snippets/cloud/integrations/cards-groups/code-repo-cards.mdx';
+
+
+
We believe configuration should be managed in code.
With config-as-code you get: version control, CI, review process.
@@ -12,4 +16,4 @@ Through integration and access to the dbt project code repository, Elementary op
### Supported code repositories
-
+
diff --git a/docs/cloud/integrations/code-repo/github.mdx b/docs/cloud/integrations/code-repo/github.mdx
index 752b6a63c..b8a8ed61e 100644
--- a/docs/cloud/integrations/code-repo/github.mdx
+++ b/docs/cloud/integrations/code-repo/github.mdx
@@ -2,6 +2,10 @@
title: "Github"
---
+import RepoConnectionSettings from '/snippets/cloud/integrations/repo-connection-settings.mdx';
+
+
+
Elementary connects to the code repository where your dbt project code is managed, and opens PRs with configuration changes.
## Recommended: Connect using Elementary Github App
@@ -51,4 +55,4 @@ If connecting the Elementary Github App isn't an option, you can connect to Gith
## Repository connection settings
-
+
diff --git a/docs/cloud/integrations/code-repo/gitlab.mdx b/docs/cloud/integrations/code-repo/gitlab.mdx
index 26383035d..4f65c192f 100644
--- a/docs/cloud/integrations/code-repo/gitlab.mdx
+++ b/docs/cloud/integrations/code-repo/gitlab.mdx
@@ -2,6 +2,10 @@
title: "Gitlab"
---
+import RepoConnectionSettings from '/snippets/cloud/integrations/repo-connection-settings.mdx';
+
+
+
Elementary connects to the code repository where your dbt project code is managed, and opens PRs with configuration changes.
@@ -34,4 +38,4 @@ You need to create a [project access token](https://docs.gitlab.com/ee/user/proj
## Repository connection settings
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/cloud/integrations/dwh/athena.mdx b/docs/cloud/integrations/dwh/athena.mdx
index a0387eb8f..f51a076c5 100644
--- a/docs/cloud/integrations/dwh/athena.mdx
+++ b/docs/cloud/integrations/dwh/athena.mdx
@@ -3,5 +3,10 @@ title: "Connect to Athena"
sidebarTitle: "Athena"
---
-
-
+import Athena from '/snippets/cloud/integrations/athena.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
+
+
diff --git a/docs/cloud/integrations/dwh/bigquery.mdx b/docs/cloud/integrations/dwh/bigquery.mdx
index 3bb44ddcb..12e0457a4 100644
--- a/docs/cloud/integrations/dwh/bigquery.mdx
+++ b/docs/cloud/integrations/dwh/bigquery.mdx
@@ -3,5 +3,10 @@ title: "Connect to Bigquery"
sidebarTitle: "Bigquery"
---
-
-
+import Bigquery from '/snippets/cloud/integrations/bigquery.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
+
+
diff --git a/docs/cloud/integrations/dwh/clickhouse.mdx b/docs/cloud/integrations/dwh/clickhouse.mdx
index b51a28034..c37e3f145 100644
--- a/docs/cloud/integrations/dwh/clickhouse.mdx
+++ b/docs/cloud/integrations/dwh/clickhouse.mdx
@@ -3,5 +3,10 @@ title: "Connect to Clickhouse"
sidebarTitle: "Clickhouse"
---
-
-
+import Clickhouse from '/snippets/cloud/integrations/clickhouse.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
+
+
diff --git a/docs/cloud/integrations/dwh/databricks.mdx b/docs/cloud/integrations/dwh/databricks.mdx
index 11b0123f3..392d8a587 100644
--- a/docs/cloud/integrations/dwh/databricks.mdx
+++ b/docs/cloud/integrations/dwh/databricks.mdx
@@ -3,5 +3,10 @@ title: "Connect to Databricks"
sidebarTitle: "Databricks"
---
-
-
+import Databricks from '/snippets/cloud/integrations/databricks.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
+
+
diff --git a/docs/cloud/integrations/dwh/dremio.mdx b/docs/cloud/integrations/dwh/dremio.mdx
index c54fdb97e..9f5f932ab 100644
--- a/docs/cloud/integrations/dwh/dremio.mdx
+++ b/docs/cloud/integrations/dwh/dremio.mdx
@@ -3,6 +3,10 @@ title: "Connect to Dremio"
sidebarTitle: "Dremio"
---
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
**Note:** We currently support **Dremio Cloud only**. If you are using Dremio Software, please contact us for assistance.
@@ -65,4 +69,4 @@ Provide the following fields:
- **Token:** The token you generated for the Elementary user.
-
+
diff --git a/docs/cloud/integrations/dwh/postgres.mdx b/docs/cloud/integrations/dwh/postgres.mdx
index 98524a10f..f34c2040a 100644
--- a/docs/cloud/integrations/dwh/postgres.mdx
+++ b/docs/cloud/integrations/dwh/postgres.mdx
@@ -3,8 +3,14 @@ title: "Connect to Postgres"
sidebarTitle: "Postgres"
---
+import CreateUserOperation from '/snippets/cloud/integrations/create-user-operation.mdx';
+import Postgres from '/snippets/cloud/integrations/postgres.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
You will connect Elementary Cloud to Postgres for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
-
-
+
+
+
diff --git a/docs/cloud/integrations/dwh/redshift.mdx b/docs/cloud/integrations/dwh/redshift.mdx
index f95902651..fb286c47b 100644
--- a/docs/cloud/integrations/dwh/redshift.mdx
+++ b/docs/cloud/integrations/dwh/redshift.mdx
@@ -3,5 +3,10 @@ title: "Connect to Redshift"
sidebarTitle: "Redshift"
---
-
-
+import Redshift from '/snippets/cloud/integrations/redshift.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
+
+
diff --git a/docs/cloud/integrations/dwh/snowflake.mdx b/docs/cloud/integrations/dwh/snowflake.mdx
index 56e902cd3..491e1ae05 100644
--- a/docs/cloud/integrations/dwh/snowflake.mdx
+++ b/docs/cloud/integrations/dwh/snowflake.mdx
@@ -3,5 +3,10 @@ title: "Connect to Snowflake"
sidebarTitle: "Snowflake"
---
-
-
+import Snowflake from '/snippets/cloud/integrations/snowflake.mdx';
+import OnboardingHelp from '/snippets/cloud/integrations/onboarding-help.mdx';
+
+
+
+
+
diff --git a/docs/cloud/integrations/elementary-integrations.mdx b/docs/cloud/integrations/elementary-integrations.mdx
index ad0547636..019e700e7 100644
--- a/docs/cloud/integrations/elementary-integrations.mdx
+++ b/docs/cloud/integrations/elementary-integrations.mdx
@@ -3,6 +3,10 @@ title: "Elementary integrations"
sidebarTitle: "All integrations"
---
+import CloudIntegrationsCards from '/snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx';
+
+
+
Elementary connects seamlessly to your data warehouse, BI tools, code repositories, alerting, and ticketing systems—giving you full context and true end-to-end, column-level lineage. This unified view makes it easy to trace issues back to their source, understand downstream impact, and resolve problems faster.
-
+
diff --git a/docs/cloud/main_introduction.mdx b/docs/cloud/main_introduction.mdx
index b11e59c20..68d5499d1 100644
--- a/docs/cloud/main_introduction.mdx
+++ b/docs/cloud/main_introduction.mdx
@@ -5,19 +5,24 @@ description: "dbt-native data observability platform built for data and analytic
icon: "fire"
---
+import QuickstartCards from '/snippets/quickstart/quickstart-cards.mdx';
+import QuickstartSteps from '/snippets/cloud/quickstart-steps.mdx';
+
+
+
Elementary includes two products:
-
+
See the [detailed comparison](/cloud/cloud-vs-oss) between Elementary Cloud and Elementary OSS.
## Get started with Elementary
-
+
### Elementary OSS
diff --git a/docs/cloud/onboarding/connect-data-warehouse.mdx b/docs/cloud/onboarding/connect-data-warehouse.mdx
index b18cebf91..b4113e246 100644
--- a/docs/cloud/onboarding/connect-data-warehouse.mdx
+++ b/docs/cloud/onboarding/connect-data-warehouse.mdx
@@ -3,6 +3,10 @@ title: "Connect data warehouse"
icon: "square-3"
---
+import ConnectDwhCards from '/snippets/cloud/integrations/cards-groups/connect-dwh-cards.mdx';
+
+
+
### Create your first environment
When you first login to Elementary, it will not have any data.
@@ -25,7 +29,7 @@ Elementary Cloud needs:
Which data warehouse do you wish to connect?
-
+
### Allowlist Elementary IP
diff --git a/docs/cloud/onboarding/quickstart-dbt-package.mdx b/docs/cloud/onboarding/quickstart-dbt-package.mdx
index fe0c35188..1a7190faf 100644
--- a/docs/cloud/onboarding/quickstart-dbt-package.mdx
+++ b/docs/cloud/onboarding/quickstart-dbt-package.mdx
@@ -4,7 +4,11 @@ sidebarTitle: "Install dbt package"
icon: "square-2"
---
-
+import QuickstartPackageInstall from '/snippets/quickstart-package-install.mdx';
+
+
+
+
## What's next?
diff --git a/docs/cloud/quickstart.mdx b/docs/cloud/quickstart.mdx
index c9d621947..3319740ed 100644
--- a/docs/cloud/quickstart.mdx
+++ b/docs/cloud/quickstart.mdx
@@ -3,6 +3,10 @@ title: "Quickstart the Elementary Cloud Platform"
sidebarTitle: "Quickstart"
icon: "circle-play"
---
+
+import QuickstartSteps from '/snippets/cloud/quickstart-steps.mdx';
+
+
There are two ways to get started, depending on what works best for your team:
- **Start a 30-day free trial** and set everything up yourself — perfect for smaller teams or hands-on users.
@@ -10,7 +14,7 @@ There are two ways to get started, depending on what works best for your team:
### Self-Serve Setup (Free Trial)
-
+
### Get the most out of Elementary
To explore everything the platform has to offer:
diff --git a/docs/data-tests/anomaly-detection-configuration/anomaly-direction.mdx b/docs/data-tests/anomaly-detection-configuration/anomaly-direction.mdx
index 37e09af22..315e05348 100644
--- a/docs/data-tests/anomaly-detection-configuration/anomaly-direction.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/anomaly-direction.mdx
@@ -2,7 +2,11 @@
title: "anomaly_direction"
sidebarTitle: "anomaly_direction"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`anomaly_direction: both | spike | drop`
diff --git a/docs/data-tests/anomaly-detection-configuration/anomaly-exclude-metrics.mdx b/docs/data-tests/anomaly-detection-configuration/anomaly-exclude-metrics.mdx
index 0834c281f..58ffaebee 100644
--- a/docs/data-tests/anomaly-detection-configuration/anomaly-exclude-metrics.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/anomaly-exclude-metrics.mdx
@@ -3,7 +3,11 @@ title: "anomaly_exclude_metrics"
sidebarTitle: "anomaly_exclude_metrics"
---
-
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
+
`anomaly_exclude_metrics: [SQL where expression on fields metric_date / metric_time_bucket / metric_value]`
diff --git a/docs/data-tests/anomaly-detection-configuration/anomaly-params.mdx b/docs/data-tests/anomaly-detection-configuration/anomaly-params.mdx
index 6e160aead..1727c4b9d 100644
--- a/docs/data-tests/anomaly-detection-configuration/anomaly-params.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/anomaly-params.mdx
@@ -3,7 +3,11 @@ title: Anomaly Tests configuration params
sidebarTitle: "All configuration params"
---
-
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
+
If your data set has a timestamp column that represents the creation time of a
diff --git a/docs/data-tests/anomaly-detection-configuration/anomaly-sensitivity.mdx b/docs/data-tests/anomaly-detection-configuration/anomaly-sensitivity.mdx
index bd3695c5f..304007167 100644
--- a/docs/data-tests/anomaly-detection-configuration/anomaly-sensitivity.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/anomaly-sensitivity.mdx
@@ -2,7 +2,11 @@
title: "anomaly_sensitivity"
sidebarTitle: "anomaly_sensitivity"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`anomaly_sensitivity: [float]`
diff --git a/docs/data-tests/anomaly-detection-configuration/column-anomalies.mdx b/docs/data-tests/anomaly-detection-configuration/column-anomalies.mdx
index 6b5922569..00ff63d03 100644
--- a/docs/data-tests/anomaly-detection-configuration/column-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/column-anomalies.mdx
@@ -2,7 +2,12 @@
title: "column_anomalies"
sidebarTitle: "column_anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+import ColumnMetrics from '/snippets/column-metrics.mdx';
+
+
+
`column_anomalies: [column monitors list]`
@@ -30,4 +35,4 @@ models:
#### Supported column monitors
-
+
diff --git a/docs/data-tests/anomaly-detection-configuration/detection-delay.mdx b/docs/data-tests/anomaly-detection-configuration/detection-delay.mdx
index 30daf80d3..bee53f0b3 100644
--- a/docs/data-tests/anomaly-detection-configuration/detection-delay.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/detection-delay.mdx
@@ -2,7 +2,11 @@
title: "detection_delay"
sidebarTitle: "detection_delay"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
```
detection_delay:
diff --git a/docs/data-tests/anomaly-detection-configuration/detection-period.mdx b/docs/data-tests/anomaly-detection-configuration/detection-period.mdx
index 7851cdf63..9a0100056 100644
--- a/docs/data-tests/anomaly-detection-configuration/detection-period.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/detection-period.mdx
@@ -2,7 +2,11 @@
title: "detection_period"
sidebarTitle: "detection_period"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
```
detection_period:
diff --git a/docs/data-tests/anomaly-detection-configuration/dimensions.mdx b/docs/data-tests/anomaly-detection-configuration/dimensions.mdx
index 5cb68de8e..1c94ad13a 100644
--- a/docs/data-tests/anomaly-detection-configuration/dimensions.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/dimensions.mdx
@@ -2,7 +2,11 @@
title: "dimensions"
sidebarTitle: "dimensions"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`dimensions: [list of SQL expressions]`
diff --git a/docs/data-tests/anomaly-detection-configuration/event_timestamp_column.mdx b/docs/data-tests/anomaly-detection-configuration/event_timestamp_column.mdx
index aeeb6d6e3..3720ee2fc 100644
--- a/docs/data-tests/anomaly-detection-configuration/event_timestamp_column.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/event_timestamp_column.mdx
@@ -2,7 +2,11 @@
title: "event_timestamp_column"
sidebarTitle: "event_timestamp_column"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`event_timestamp_column: [column name]`
diff --git a/docs/data-tests/anomaly-detection-configuration/exclude-final-results.mdx b/docs/data-tests/anomaly-detection-configuration/exclude-final-results.mdx
index 6859afee0..741d3d3f0 100644
--- a/docs/data-tests/anomaly-detection-configuration/exclude-final-results.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/exclude-final-results.mdx
@@ -2,7 +2,11 @@
title: "exclude_final_results"
sidebarTitle: "exclude_final_results"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`exclude_final_results: [SQL where expression on fields value / average]`
diff --git a/docs/data-tests/anomaly-detection-configuration/exclude_prefix.mdx b/docs/data-tests/anomaly-detection-configuration/exclude_prefix.mdx
index 486bd48b8..d2a6ae7a2 100644
--- a/docs/data-tests/anomaly-detection-configuration/exclude_prefix.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/exclude_prefix.mdx
@@ -2,7 +2,11 @@
title: "exclude_prefix"
sidebarTitle: "exclude_prefix"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`exclude_prefix: [string]`
diff --git a/docs/data-tests/anomaly-detection-configuration/exclude_regexp.mdx b/docs/data-tests/anomaly-detection-configuration/exclude_regexp.mdx
index c3f566222..ed12b7516 100644
--- a/docs/data-tests/anomaly-detection-configuration/exclude_regexp.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/exclude_regexp.mdx
@@ -2,7 +2,11 @@
title: "exclude_regexp"
sidebarTitle: "exclude_regexp"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`exclude_regexp: [regex]`
diff --git a/docs/data-tests/anomaly-detection-configuration/fail_on_zero.mdx b/docs/data-tests/anomaly-detection-configuration/fail_on_zero.mdx
index b8d5bab62..c7dc3d536 100644
--- a/docs/data-tests/anomaly-detection-configuration/fail_on_zero.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/fail_on_zero.mdx
@@ -2,7 +2,11 @@
title: "fail_on_zero"
sidebarTitle: "fail_on_zero"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`fail_on_zero: true/false`
diff --git a/docs/data-tests/anomaly-detection-configuration/ignore_small_changes.mdx b/docs/data-tests/anomaly-detection-configuration/ignore_small_changes.mdx
index 84c95f1ee..81a4a23eb 100644
--- a/docs/data-tests/anomaly-detection-configuration/ignore_small_changes.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/ignore_small_changes.mdx
@@ -2,7 +2,11 @@
title: "ignore_small_changes"
sidebarTitle: "ignore_small_changes"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
```
ignore_small_changes:
diff --git a/docs/data-tests/anomaly-detection-configuration/seasonality.mdx b/docs/data-tests/anomaly-detection-configuration/seasonality.mdx
index d21fccece..0f0014e83 100644
--- a/docs/data-tests/anomaly-detection-configuration/seasonality.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/seasonality.mdx
@@ -2,7 +2,11 @@
title: "seasonality"
sidebarTitle: "seasonality"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`seasonality: day_of_week | hour_of_day | hour_of_week`
diff --git a/docs/data-tests/anomaly-detection-configuration/time-bucket.mdx b/docs/data-tests/anomaly-detection-configuration/time-bucket.mdx
index 8b2399cff..51762e3de 100644
--- a/docs/data-tests/anomaly-detection-configuration/time-bucket.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/time-bucket.mdx
@@ -2,7 +2,11 @@
title: "time_bucket"
sidebarTitle: "time_bucket"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
```
time_bucket:
diff --git a/docs/data-tests/anomaly-detection-configuration/timestamp-column.mdx b/docs/data-tests/anomaly-detection-configuration/timestamp-column.mdx
index 15522255f..4e3f80136 100644
--- a/docs/data-tests/anomaly-detection-configuration/timestamp-column.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/timestamp-column.mdx
@@ -2,7 +2,11 @@
title: "timestamp_column"
sidebarTitle: "timestamp_column"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`timestamp_column: [column name]`
diff --git a/docs/data-tests/anomaly-detection-configuration/training-period.mdx b/docs/data-tests/anomaly-detection-configuration/training-period.mdx
index 09ae5aed8..499cfc72a 100644
--- a/docs/data-tests/anomaly-detection-configuration/training-period.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/training-period.mdx
@@ -2,7 +2,11 @@
title: "training_period"
sidebarTitle: "training_period"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
```
training_period:
diff --git a/docs/data-tests/anomaly-detection-configuration/update_timestamp_column.mdx b/docs/data-tests/anomaly-detection-configuration/update_timestamp_column.mdx
index 0ddbe6414..f4bc0ee79 100644
--- a/docs/data-tests/anomaly-detection-configuration/update_timestamp_column.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/update_timestamp_column.mdx
@@ -2,7 +2,11 @@
title: "update_timestamp_column"
sidebarTitle: "update_timestamp_column"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`update_timestamp_column: [column name]`
diff --git a/docs/data-tests/anomaly-detection-configuration/where-expression.mdx b/docs/data-tests/anomaly-detection-configuration/where-expression.mdx
index e0beb045e..470f68e4a 100644
--- a/docs/data-tests/anomaly-detection-configuration/where-expression.mdx
+++ b/docs/data-tests/anomaly-detection-configuration/where-expression.mdx
@@ -2,7 +2,11 @@
title: "where_expression"
sidebarTitle: "where_expression"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`where_expression: [sql expression]`
diff --git a/docs/data-tests/anomaly-detection-tests/Anomaly-troubleshooting-guide.mdx b/docs/data-tests/anomaly-detection-tests/Anomaly-troubleshooting-guide.mdx
index b24933b5b..200b5f884 100644
--- a/docs/data-tests/anomaly-detection-tests/Anomaly-troubleshooting-guide.mdx
+++ b/docs/data-tests/anomaly-detection-tests/Anomaly-troubleshooting-guide.mdx
@@ -2,7 +2,11 @@
title: "Anomaly Tests Troubleshooting"
sidebarTitle: "Anomaly tests troubleshooting"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
diff --git a/docs/data-tests/anomaly-detection-tests/all-columns-anomalies.mdx b/docs/data-tests/anomaly-detection-tests/all-columns-anomalies.mdx
index a2c177135..3aadbb9a3 100644
--- a/docs/data-tests/anomaly-detection-tests/all-columns-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-tests/all-columns-anomalies.mdx
@@ -2,7 +2,12 @@
sidebarTitle: "All columns anomalies"
title: "all_columns_anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+import ColumnMetrics from '/snippets/column-metrics.mdx';
+
+
+
`elementary.all_columns_anomalies`
@@ -13,7 +18,7 @@ Specific monitors are detailed in the table below and can be configured using th
The test checks the data type of each column and only executes monitors that are relevant to it.
You can use `column_anomalies` param to override the default monitors, and `exclude_prefix` / `exclude_regexp` to exclude columns from the test.
-
+
### Test configuration
diff --git a/docs/data-tests/anomaly-detection-tests/column-anomalies.mdx b/docs/data-tests/anomaly-detection-tests/column-anomalies.mdx
index b7caa1277..b352ae037 100644
--- a/docs/data-tests/anomaly-detection-tests/column-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-tests/column-anomalies.mdx
@@ -2,7 +2,12 @@
title: "column_anomalies"
sidebarTitle: "Column anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+import ColumnMetrics from '/snippets/column-metrics.mdx';
+
+
+
`elementary.column_anomalies`
@@ -11,7 +16,7 @@ Specific monitors are detailed in the table below and can be configured using th
The test checks the data type of the column and only executes monitors that are relevant to it.
-
+
### Test configuration
diff --git a/docs/data-tests/anomaly-detection-tests/dimension-anomalies.mdx b/docs/data-tests/anomaly-detection-tests/dimension-anomalies.mdx
index fab3592d1..bc1ab4700 100644
--- a/docs/data-tests/anomaly-detection-tests/dimension-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-tests/dimension-anomalies.mdx
@@ -2,7 +2,11 @@
sidebarTitle: "Dimension anomalies"
title: "dimension_anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`elementary.dimension_anomalies`
diff --git a/docs/data-tests/anomaly-detection-tests/event-freshness-anomalies.mdx b/docs/data-tests/anomaly-detection-tests/event-freshness-anomalies.mdx
index 2425a8482..675a347c0 100644
--- a/docs/data-tests/anomaly-detection-tests/event-freshness-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-tests/event-freshness-anomalies.mdx
@@ -2,7 +2,11 @@
sidebarTitle: "Event freshness anomalies"
title: "event_freshness_anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`elementary.event_freshness_anomalies`
diff --git a/docs/data-tests/anomaly-detection-tests/freshness-anomalies.mdx b/docs/data-tests/anomaly-detection-tests/freshness-anomalies.mdx
index 0dfb87a62..108f0b5ef 100644
--- a/docs/data-tests/anomaly-detection-tests/freshness-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-tests/freshness-anomalies.mdx
@@ -2,7 +2,11 @@
title: "freshness_anomalies"
sidebarTitle: "Freshness anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`elementary.freshness_anomalies`
diff --git a/docs/data-tests/anomaly-detection-tests/volume-anomalies.mdx b/docs/data-tests/anomaly-detection-tests/volume-anomalies.mdx
index 36db1ee5a..724d564e4 100644
--- a/docs/data-tests/anomaly-detection-tests/volume-anomalies.mdx
+++ b/docs/data-tests/anomaly-detection-tests/volume-anomalies.mdx
@@ -2,7 +2,11 @@
title: "volume_anomalies"
sidebarTitle: "Volume anomalies"
---
-
+
+import AiGenerateTest from '/snippets/ai-generate-test.mdx';
+
+
+
`elementary.volume_anomalies`
diff --git a/docs/data-tests/dbt/dbt-package.mdx b/docs/data-tests/dbt/dbt-package.mdx
index adbc2de59..a9692fd89 100644
--- a/docs/data-tests/dbt/dbt-package.mdx
+++ b/docs/data-tests/dbt/dbt-package.mdx
@@ -3,6 +3,10 @@ title: "Elementary dbt package"
sidebarTitle: "Introduction"
---
+import QuestionSchemaNoAccordion from '/snippets/faq/question-schema-no-accordion.mdx';
+
+
+
The Elementary dbt package serves as a collector of logs and metadata from your dbt project and offers a set of data anomaly detection and schema tests.
To gain the most value from the dbt package, we recommend using it with the [Elementary Cloud Platform](/cloud/introduction) or with [Elementary open-source CLI tool](/oss/oss-introduction).
@@ -39,7 +43,7 @@ After you deploy the dbt package, you can use Elementary tests, and your dbt art
## Elementary schema
-
+
## Package full refresh
diff --git a/docs/data-tests/dbt/quickstart-package.mdx b/docs/data-tests/dbt/quickstart-package.mdx
index aaa47ae00..396763186 100644
--- a/docs/data-tests/dbt/quickstart-package.mdx
+++ b/docs/data-tests/dbt/quickstart-package.mdx
@@ -3,7 +3,11 @@ title: "Quickstart: Install Elementary dbt package"
sidebarTitle: "Install dbt package"
---
-
+import QuickstartPackageInstall from '/snippets/quickstart-package-install.mdx';
+
+
+
+
## What's next?
diff --git a/docs/data-tests/introduction.mdx b/docs/data-tests/introduction.mdx
index 418adab74..fd7546849 100644
--- a/docs/data-tests/introduction.mdx
+++ b/docs/data-tests/introduction.mdx
@@ -3,6 +3,10 @@ title: "Elementary Data Tests"
sidebarTitle: "Introduction"
---
+import TestsCards from '/snippets/data-tests/tests-cards.mdx';
+
+
+
Elementary provides anomaly tests for detection of data quality issues.
Elementary data tests are configured and executed like native tests in your dbt project.
@@ -18,7 +22,7 @@ Together, these tests ensure reliable pipelines and trusted data.
In addition to the mentioned dbt package tests, the [Elementary Cloud Platform](https://docs.elementary-data.com/cloud/introduction) offers **automated pipeline tests.** While traditional tests query the dbt tables directly, automated pipeline tests analyze **query history metadata**. This method is both **faster and more cost-efficient**, as it eliminates the need to query large datasets, focusing solely on the metadata layer. Learn more about [automated tests](https://docs.elementary-data.com/features/anomaly-detection/automated-monitors).
-
+
## Anomaly detection tests
diff --git a/docs/oss/cli-install.mdx b/docs/oss/cli-install.mdx
index 6091b0cb1..98e0e770a 100644
--- a/docs/oss/cli-install.mdx
+++ b/docs/oss/cli-install.mdx
@@ -2,9 +2,16 @@
title: "CLI install & configure"
---
+import InstallCli from '/snippets/install-cli.mdx';
+import AddConnectionProfile from '/snippets/add-connection-profile.mdx';
+import QuestionConnectionProfile from '/snippets/faq/question-connection-profile.mdx';
+import QuestionProfilePermissions from '/snippets/faq/question-profile-permissions.mdx';
+
+
+
We recommend you install Elementary CLI using one of the following methods:
-
+
## Install from source
@@ -33,7 +40,7 @@ Elementary CLI requires a connection profile to connect to DWH. Additional confi
(These default paths and names may be changed using the [CLI options](/oss/cli-commands#cli-advanced-options)).
-
+
@@ -44,8 +51,8 @@ If you are a dbt user, you already have a `profiles.yml` file that you can use.
-
-
+
+
diff --git a/docs/oss/deployment-and-configuration/elementary-in-production.mdx b/docs/oss/deployment-and-configuration/elementary-in-production.mdx
index d526ae7cb..afaee4e80 100644
--- a/docs/oss/deployment-and-configuration/elementary-in-production.mdx
+++ b/docs/oss/deployment-and-configuration/elementary-in-production.mdx
@@ -2,7 +2,11 @@
title: "Elementary in production"
---
+import QuickstartElementaryProd from '/snippets/quickstart/quickstart-elementary-prod.mdx';
+
+
+
**Running Elementary OSS in production means to include the dbt package in your production dbt project,
and setting up an automated manner to run the Elementary CLI.**
-
+
diff --git a/docs/oss/deployment-and-configuration/slack.mdx b/docs/oss/deployment-and-configuration/slack.mdx
index 18079bc65..5f859a698 100644
--- a/docs/oss/deployment-and-configuration/slack.mdx
+++ b/docs/oss/deployment-and-configuration/slack.mdx
@@ -3,6 +3,10 @@ title: "Slack setup for Elementary CLI"
sidebarTitle: "Slack"
---
+import SetupSlackIntegration from '/snippets/setup-slack-integration.mdx';
+
+
+
Elementary Slack integration includes sending [Slack alerts](/oss/guides/alerts/send-slack-alerts) on failures in dbt tests and models, and the option to distribute the [data observability report](/oss/guides/generate-report-ui) as a message attachment.
## Token vs Webhook
@@ -23,7 +27,7 @@ Below is features support comparison table, to help you select the integration m
## Slack integration setup
-
+
---
diff --git a/docs/oss/deployment-and-configuration/teams.mdx b/docs/oss/deployment-and-configuration/teams.mdx
index 802dec1b3..de32fcb66 100644
--- a/docs/oss/deployment-and-configuration/teams.mdx
+++ b/docs/oss/deployment-and-configuration/teams.mdx
@@ -3,6 +3,10 @@ title: "Teams setup for Elementary CLI"
sidebarTitle: "Teams"
---
+import SetupTeamsIntegration from '/snippets/setup-teams-integration.mdx';
+
+
+
Elementary Teams integration includes sending [Teams alerts](/oss/guides/alerts/send-teams-alerts) on failures in dbt tests and models. The alerts are sent using Microsoft Teams Adaptive Cards format, which provides rich formatting and interactive capabilities.
MS Teams supports Elementary Alerts, but unlike Slack, it does not support the Elementary report or multiple channels.
@@ -20,4 +24,4 @@ There are two ways to create a webhook for Microsoft Teams:
## Teams integration setup
-
+
diff --git a/docs/oss/general/community-and-support.mdx b/docs/oss/general/community-and-support.mdx
index ef76ef22d..dce2afcb6 100644
--- a/docs/oss/general/community-and-support.mdx
+++ b/docs/oss/general/community-and-support.mdx
@@ -2,4 +2,8 @@
title: "Community and Support"
---
-
+import SupportContact from '/snippets/support-contact.mdx';
+
+
+
+
diff --git a/docs/oss/general/faq.mdx b/docs/oss/general/faq.mdx
index d4744258b..9ef95b5f7 100644
--- a/docs/oss/general/faq.mdx
+++ b/docs/oss/general/faq.mdx
@@ -3,18 +3,33 @@ title: "FAQ"
description: "This section is aimed at collecting common questions users have to provide documented answers."
---
-
-
-
-
-
-
-
-
-
-
-
-
+import QuestionDisableHooks from '/snippets/faq/question-disable-hooks.mdx';
+import QuestionFilterElementaryTests from '/snippets/faq/question-filter-elementary-tests.mdx';
+import QuestionDisableElementaryModels from '/snippets/faq/question-disable-elementary-models.mdx';
+import QuestionChangeElementarySchema from '/snippets/faq/question-change-elementary-schema.mdx';
+import QuestionSchema from '/snippets/faq/question-schema.mdx';
+import QuestionWhichTests from '/snippets/faq/question-which-tests.mdx';
+import QuestionSingularTestsConfig from '/snippets/faq/question-singular-tests-config.mdx';
+import QuestionFullRefresh from '/snippets/faq/question-full-refresh.mdx';
+import QuestionElementaryPermissions from '/snippets/faq/question-elementary-permissions.mdx';
+import QuestionDbtCloud from '/snippets/faq/question-dbt-cloud.mdx';
+import QuestionTestResultsSample from '/snippets/faq/question-test-results-sample.mdx';
+import QuestionCost from '/snippets/faq/question-cost.mdx';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/oss/general/troubleshooting.mdx b/docs/oss/general/troubleshooting.mdx
index 2c1c534de..1bb08f69c 100644
--- a/docs/oss/general/troubleshooting.mdx
+++ b/docs/oss/general/troubleshooting.mdx
@@ -3,6 +3,10 @@ title: "Troubleshooting"
description: "This section is aimed at collecting common issues users have to provide quick debug solutions."
---
+import Dbt18MaterializationsCommon from '/snippets/dbt-18-materializations-common.mdx';
+
+
+
If you get an empty report, there are several steps to understand what went wrong and try and fix it.
@@ -164,7 +168,7 @@ python3 -m pip install elementary-data[]
-
+
If you are encountering the warning above though, it means that you have previously added the flag
`require_explicit_package_overrides_for_builtin_materializations=False` to `dbt-project.yml`.
diff --git a/docs/oss/guides/alerts/alerts-configuration.mdx b/docs/oss/guides/alerts/alerts-configuration.mdx
index e10e3427e..7d9a700cd 100644
--- a/docs/oss/guides/alerts/alerts-configuration.mdx
+++ b/docs/oss/guides/alerts/alerts-configuration.mdx
@@ -3,7 +3,11 @@ title: "Alerts Configuration and Customization"
sidebarTitle: "Alerts configuration"
---
-
+import AlertsCodeConfiguration from '/snippets/guides/alerts-code-configuration.mdx';
+
+
+
+
## Alerts CLI flags
diff --git a/docs/oss/guides/alerts/elementary-alerts.mdx b/docs/oss/guides/alerts/elementary-alerts.mdx
index 1f4c3f5d5..469313bb5 100644
--- a/docs/oss/guides/alerts/elementary-alerts.mdx
+++ b/docs/oss/guides/alerts/elementary-alerts.mdx
@@ -2,11 +2,15 @@
title: "Elementary alerts"
---
+import AlertsIntroduction from '/snippets/alerts/alerts-introduction.mdx';
+
+
+
More alerts integrations are coming soon, reach out to us for details!
-
+
@@ -14,7 +18,7 @@ This is **required for the alerts to work.**
-
+
## Execute the CLI
diff --git a/docs/oss/guides/alerts/send-teams-alerts.mdx b/docs/oss/guides/alerts/send-teams-alerts.mdx
index fe2665983..988035cf3 100644
--- a/docs/oss/guides/alerts/send-teams-alerts.mdx
+++ b/docs/oss/guides/alerts/send-teams-alerts.mdx
@@ -2,6 +2,10 @@
title: "Setup Teams alerts"
---
+import SetupTeamsIntegration from '/snippets/setup-teams-integration.mdx';
+
+
+
**Before you start**
@@ -14,7 +18,7 @@ Elementary sends alerts using Microsoft Teams Adaptive Cards format, which provi
-
+
## Execute the CLI
diff --git a/docs/oss/guides/collect-dbt-source-freshness.mdx b/docs/oss/guides/collect-dbt-source-freshness.mdx
index 131a1f277..f9863c442 100644
--- a/docs/oss/guides/collect-dbt-source-freshness.mdx
+++ b/docs/oss/guides/collect-dbt-source-freshness.mdx
@@ -3,4 +3,8 @@ title: "Collect dbt source freshness results"
sidebarTitle: "dbt source freshness"
---
-
\ No newline at end of file
+import DbtSourceFreshness from '/snippets/guides/dbt-source-freshness.mdx';
+
+
+
+
\ No newline at end of file
diff --git a/docs/oss/guides/collect-job-data.mdx b/docs/oss/guides/collect-job-data.mdx
index 72361e2b1..923a8d648 100644
--- a/docs/oss/guides/collect-job-data.mdx
+++ b/docs/oss/guides/collect-job-data.mdx
@@ -3,4 +3,8 @@ title: "Collect jobs info from orchestrator"
sidebarTitle: "Collect jobs data"
---
-
+import CollectJobData from '/snippets/guides/collect-job-data.mdx';
+
+
+
+
diff --git a/docs/oss/guides/generate-report-ui.mdx b/docs/oss/guides/generate-report-ui.mdx
index c97516900..3040c64ab 100644
--- a/docs/oss/guides/generate-report-ui.mdx
+++ b/docs/oss/guides/generate-report-ui.mdx
@@ -2,6 +2,13 @@
title: "Generate observability report"
---
+import InstallDbtPackage from '/snippets/install-dbt-package.mdx';
+import AddConnectionProfile from '/snippets/add-connection-profile.mdx';
+import InstallCli from '/snippets/install-cli.mdx';
+import ShareReport from '/snippets/share-report.mdx';
+
+
+
Elementary [data observability report](cloud/features/collaboration-and-communication/data-observability-dashboard) can be used for visualization and exploration of data from the dbt-package tables. That includes dbt test results, Elementary anomaly detection results, dbt artifacts, tests runs, etc.
@@ -18,19 +25,19 @@ This is **required for the report to work.**
-
+
-
+
-
+
@@ -69,4 +76,4 @@ edr report --select invocation_id:XXXXXXXXXXXXX
---
-
+
diff --git a/docs/oss/integrations/bigquery.mdx b/docs/oss/integrations/bigquery.mdx
index 1674db61c..915ad3b60 100644
--- a/docs/oss/integrations/bigquery.mdx
+++ b/docs/oss/integrations/bigquery.mdx
@@ -2,12 +2,17 @@
title: "BigQuery"
---
+import Bigquery from '/snippets/cloud/integrations/bigquery.mdx';
+import BigqueryCli from '/snippets/cli/bigquery-cli.mdx';
+
+
+
-
+
-
+
diff --git a/docs/oss/integrations/clickhouse.mdx b/docs/oss/integrations/clickhouse.mdx
index 07edfdf76..c40ea112a 100644
--- a/docs/oss/integrations/clickhouse.mdx
+++ b/docs/oss/integrations/clickhouse.mdx
@@ -2,9 +2,13 @@
title: "Clickhouse"
---
+import ClickhouseCli from '/snippets/cli/clickhouse-cli.mdx';
+
+
+
-
+
diff --git a/docs/oss/integrations/databricks.mdx b/docs/oss/integrations/databricks.mdx
index ae817d004..a42621996 100644
--- a/docs/oss/integrations/databricks.mdx
+++ b/docs/oss/integrations/databricks.mdx
@@ -2,12 +2,17 @@
title: "Databricks"
---
+import Databricks from '/snippets/cloud/integrations/databricks.mdx';
+import DatabricksCli from '/snippets/cli/databricks-cli.mdx';
+
+
+
-
+
-
+
diff --git a/docs/oss/integrations/dbt.mdx b/docs/oss/integrations/dbt.mdx
index 01faf86cb..ae9ed063b 100644
--- a/docs/oss/integrations/dbt.mdx
+++ b/docs/oss/integrations/dbt.mdx
@@ -2,6 +2,11 @@
title: "dbt core & dbt cloud"
---
+import QuestionConnectionProfile from '/snippets/faq/question-connection-profile.mdx';
+import QuestionProfilePermissions from '/snippets/faq/question-profile-permissions.mdx';
+
+
+
Elementary OSS integrates with dbt core (1.3.0 and above) and dbt cloud, as long as the data warehouse is supported.
Both dbt core and cloud users need to [deploy the dbt package](/oss/quickstart/quickstart-cli-package) first in the monitored project.
@@ -26,5 +31,5 @@ Here are the detailed steps for using Elementary on dbt cloud:
Use to create the profile, [this guide](/oss/quickstart/quickstart-cli) install the CLI, and run it.
-
-
+
+
diff --git a/docs/oss/integrations/dremio.mdx b/docs/oss/integrations/dremio.mdx
index e0c381202..619452321 100644
--- a/docs/oss/integrations/dremio.mdx
+++ b/docs/oss/integrations/dremio.mdx
@@ -2,12 +2,17 @@
title: "Dremio"
---
+import Dremio from '/snippets/cloud/integrations/dremio.mdx';
+import DremioCli from '/snippets/cli/dremio-cli.mdx';
+
+
+
-
+
-
+
diff --git a/docs/oss/integrations/postgres.mdx b/docs/oss/integrations/postgres.mdx
index 6e60f6639..e0dbff126 100644
--- a/docs/oss/integrations/postgres.mdx
+++ b/docs/oss/integrations/postgres.mdx
@@ -2,12 +2,17 @@
title: "Postgres"
---
+import Postgres from '/snippets/cloud/integrations/postgres.mdx';
+import PostgresCli from '/snippets/cli/postgres-cli.mdx';
+
+
+
-
+
-
+
diff --git a/docs/oss/integrations/redshift.mdx b/docs/oss/integrations/redshift.mdx
index 4dacbc4fa..67f82ac9b 100644
--- a/docs/oss/integrations/redshift.mdx
+++ b/docs/oss/integrations/redshift.mdx
@@ -2,12 +2,17 @@
title: "Redshift"
---
+import Redshift from '/snippets/cloud/integrations/redshift.mdx';
+import RedshiftCli from '/snippets/cli/redshift-cli.mdx';
+
+
+
-
+
-
+
diff --git a/docs/oss/integrations/snowflake.mdx b/docs/oss/integrations/snowflake.mdx
index dc1419c0a..6f5763f1b 100644
--- a/docs/oss/integrations/snowflake.mdx
+++ b/docs/oss/integrations/snowflake.mdx
@@ -2,12 +2,17 @@
title: "Snowflake"
---
+import Snowflake from '/snippets/cloud/integrations/snowflake.mdx';
+import SnowflakeCli from '/snippets/cli/snowflake-cli.mdx';
+
+
+
-
+
-
+
diff --git a/docs/oss/oss-introduction.mdx b/docs/oss/oss-introduction.mdx
index d513c20ba..7f006816f 100644
--- a/docs/oss/oss-introduction.mdx
+++ b/docs/oss/oss-introduction.mdx
@@ -3,6 +3,10 @@ title: "Elementary OSS"
sidebarTitle: "Introduction"
icon: "square-terminal"
---
+
+import AdaptersCards from '/snippets/oss/adapters-cards.mdx';
+
+
**Elementary OSS is a CLI tool that works alongside the [Elementary dbt package](/data-tests/dbt/dbt-package).** With the dbt package, you gain powerful anomaly detection tests and metadata tables to monitor data quality trends over time.
By deploying the CLI, you can **send alerts and self-host the Elementary data observability report**, a comprehensive view of your dbt runs and all dbt test results, helping you track data lineage, test coverage, and overall pipeline health.
@@ -32,7 +36,7 @@ For a scalable and collaborative data quality platform, **look into the [Element
### Supported adapters
-
+
diff --git a/docs/oss/quickstart/quickstart-alerts.mdx b/docs/oss/quickstart/quickstart-alerts.mdx
index 70d88d00d..6a85c99bd 100644
--- a/docs/oss/quickstart/quickstart-alerts.mdx
+++ b/docs/oss/quickstart/quickstart-alerts.mdx
@@ -4,9 +4,13 @@ sidebarTitle: "Setup alerts"
icon: "square-5"
---
+import AlertsIntroduction from '/snippets/alerts/alerts-introduction.mdx';
+
+
+
**Elementary helps you stay on top of data issues by generating Slack and Microsoft Teams alerts for test failures, anomalies, and other data reliability signals.**
-
+
+import QuickstartPackageInstall from '/snippets/quickstart-package-install.mdx';
+
+
+
+
## What's next?
diff --git a/docs/oss/quickstart/quickstart-cli.mdx b/docs/oss/quickstart/quickstart-cli.mdx
index 61a373ffa..4ae10514c 100644
--- a/docs/oss/quickstart/quickstart-cli.mdx
+++ b/docs/oss/quickstart/quickstart-cli.mdx
@@ -3,18 +3,26 @@ title: "Quickstart: Elementary CLI"
sidebarTitle: "Install Elementary CLI"
icon: "square-2"
---
+
+import InstallDbtPackage from '/snippets/install-dbt-package.mdx';
+import AddConnectionProfile from '/snippets/add-connection-profile.mdx';
+import QuestionConnectionProfile from '/snippets/faq/question-connection-profile.mdx';
+import QuestionProfilePermissions from '/snippets/faq/question-profile-permissions.mdx';
+import InstallCli from '/snippets/install-cli.mdx';
+
+
Elementary supports Python versions 3.9 - 3.12, aligning with the [versions supported by dbt](https://docs.getdbt.com/faqs/Core/install-python-compatibility#python-compatibility-matrix).
Before installing the CLI, make sure to complete the steps dbt package installation, including executing `dbt run` with the Elementary package models.
-
+
-
+
-
+
-
+
-
+
diff --git a/docs/oss/quickstart/quickstart-prod.mdx b/docs/oss/quickstart/quickstart-prod.mdx
index e9957d3ee..eeb01432e 100644
--- a/docs/oss/quickstart/quickstart-prod.mdx
+++ b/docs/oss/quickstart/quickstart-prod.mdx
@@ -3,7 +3,11 @@ title: "Quickstart: Deploy in Production"
sidebarTitle: "Deploy in production"
icon: "square-6"
---
+
+import QuickstartElementaryProd from '/snippets/quickstart/quickstart-elementary-prod.mdx';
+
+
**Running Elementary OSS in production means to include the dbt package in your production dbt project,
and setting up an automated manner to run the Elementary CLI.** This step is optional, but it will help you automate, control and scale Elementary OSS.
-
+
diff --git a/docs/oss/quickstart/quickstart-report.mdx b/docs/oss/quickstart/quickstart-report.mdx
index 86824581f..f6a5941a6 100644
--- a/docs/oss/quickstart/quickstart-report.mdx
+++ b/docs/oss/quickstart/quickstart-report.mdx
@@ -4,6 +4,10 @@ sidebarTitle: "Generate observability report"
icon: "square-4"
---
+import ShareReport from '/snippets/share-report.mdx';
+
+
+
**Elementary [data observability report](cloud/features/collaboration-and-communication/data-observability-dashboard) can be used for visualization and exploration of data from the dbt-package tables. That includes dbt test results, Elementary anomaly detection results, dbt artifacts, tests runs, etc.**
@@ -50,4 +54,4 @@ edr report --select invocation_id:XXXXXXXXXXXXX
---
-
+
diff --git a/docs/overview/elementary-cloud.mdx b/docs/overview/elementary-cloud.mdx
index 17675f7d5..e9c4ffd32 100644
--- a/docs/overview/elementary-cloud.mdx
+++ b/docs/overview/elementary-cloud.mdx
@@ -4,7 +4,12 @@ sidebarTitle: "Elementary Cloud"
icon: "cloud"
---
-
+import IntroductionOpening from '/snippets/cloud/introduction-opening.mdx';
+import Introduction from '/snippets/cloud/introduction.mdx';
+
+
+
+
-
+
diff --git a/docs/_snippets/add-connection-profile.mdx b/docs/snippets/add-connection-profile.mdx
similarity index 94%
rename from docs/_snippets/add-connection-profile.mdx
rename to docs/snippets/add-connection-profile.mdx
index 9f7a24289..964050ace 100644
--- a/docs/_snippets/add-connection-profile.mdx
+++ b/docs/snippets/add-connection-profile.mdx
@@ -1,3 +1,5 @@
+import AllProfiles from '/snippets/profiles/all-profiles.mdx';
+
## Configuring the Elementary Profile
In order to connect, Elementary needs a [connection profile](https://docs.getdbt.com/dbt-cli/configure-your-profile) in a file named `profiles.yml`.
@@ -40,4 +42,4 @@ Here is a demonstration:
- Profile name: `elementary`
- Schema name: The schema of elementary models, default is `_elementary`
-
+
diff --git a/docs/_snippets/ai-generate-test.mdx b/docs/snippets/ai-generate-test.mdx
similarity index 100%
rename from docs/_snippets/ai-generate-test.mdx
rename to docs/snippets/ai-generate-test.mdx
diff --git a/docs/_snippets/alerts/alerts-configuration.mdx b/docs/snippets/alerts/alerts-configuration.mdx
similarity index 100%
rename from docs/_snippets/alerts/alerts-configuration.mdx
rename to docs/snippets/alerts/alerts-configuration.mdx
diff --git a/docs/_snippets/alerts/alerts-introduction.mdx b/docs/snippets/alerts/alerts-introduction.mdx
similarity index 100%
rename from docs/_snippets/alerts/alerts-introduction.mdx
rename to docs/snippets/alerts/alerts-introduction.mdx
diff --git a/docs/_snippets/alerts/description.mdx b/docs/snippets/alerts/description.mdx
similarity index 100%
rename from docs/_snippets/alerts/description.mdx
rename to docs/snippets/alerts/description.mdx
diff --git a/docs/_snippets/alerts/owner.mdx b/docs/snippets/alerts/owner.mdx
similarity index 100%
rename from docs/_snippets/alerts/owner.mdx
rename to docs/snippets/alerts/owner.mdx
diff --git a/docs/_snippets/alerts/subscribers.mdx b/docs/snippets/alerts/subscribers.mdx
similarity index 100%
rename from docs/_snippets/alerts/subscribers.mdx
rename to docs/snippets/alerts/subscribers.mdx
diff --git a/docs/_snippets/alerts/tags.mdx b/docs/snippets/alerts/tags.mdx
similarity index 100%
rename from docs/_snippets/alerts/tags.mdx
rename to docs/snippets/alerts/tags.mdx
diff --git a/docs/_snippets/cli/bigquery-cli.mdx b/docs/snippets/cli/bigquery-cli.mdx
similarity index 93%
rename from docs/_snippets/cli/bigquery-cli.mdx
rename to docs/snippets/cli/bigquery-cli.mdx
index da1f0152b..9771ed96f 100644
--- a/docs/_snippets/cli/bigquery-cli.mdx
+++ b/docs/snippets/cli/bigquery-cli.mdx
@@ -1,3 +1,5 @@
+import CliServiceAccount from '/snippets/dwh/bigquery/cli_service_account.mdx';
+
### BigQuery connection profile
After installing Elementary's dbt package upon running `dbt deps`,
@@ -38,7 +40,7 @@ elementary:
We support the same format and connection methods as dbt. Please refer to dbt's documentation
of [BigQuery](https://docs.getdbt.com/reference/warehouse-setups/bigquery-setup) for further details.
-
+
Add the full path of this JSON file to your connection profile under 'keyfile'.
diff --git a/docs/_snippets/cli/clickhouse-cli.mdx b/docs/snippets/cli/clickhouse-cli.mdx
similarity index 100%
rename from docs/_snippets/cli/clickhouse-cli.mdx
rename to docs/snippets/cli/clickhouse-cli.mdx
diff --git a/docs/_snippets/cli/databricks-cli.mdx b/docs/snippets/cli/databricks-cli.mdx
similarity index 100%
rename from docs/_snippets/cli/databricks-cli.mdx
rename to docs/snippets/cli/databricks-cli.mdx
diff --git a/docs/_snippets/cli/postgres-cli.mdx b/docs/snippets/cli/postgres-cli.mdx
similarity index 100%
rename from docs/_snippets/cli/postgres-cli.mdx
rename to docs/snippets/cli/postgres-cli.mdx
diff --git a/docs/_snippets/cli/redshift-cli.mdx b/docs/snippets/cli/redshift-cli.mdx
similarity index 100%
rename from docs/_snippets/cli/redshift-cli.mdx
rename to docs/snippets/cli/redshift-cli.mdx
diff --git a/docs/_snippets/cli/snowflake-cli.mdx b/docs/snippets/cli/snowflake-cli.mdx
similarity index 100%
rename from docs/_snippets/cli/snowflake-cli.mdx
rename to docs/snippets/cli/snowflake-cli.mdx
diff --git a/docs/_snippets/cloud/ai-privacy-policy-short.mdx b/docs/snippets/cloud/ai-privacy-policy-short.mdx
similarity index 100%
rename from docs/_snippets/cloud/ai-privacy-policy-short.mdx
rename to docs/snippets/cloud/ai-privacy-policy-short.mdx
diff --git a/docs/_snippets/cloud/cloud-feature-tag.mdx b/docs/snippets/cloud/cloud-feature-tag.mdx
similarity index 100%
rename from docs/_snippets/cloud/cloud-feature-tag.mdx
rename to docs/snippets/cloud/cloud-feature-tag.mdx
diff --git a/docs/_snippets/cloud/features.mdx b/docs/snippets/cloud/features.mdx
similarity index 100%
rename from docs/_snippets/cloud/features.mdx
rename to docs/snippets/cloud/features.mdx
diff --git a/docs/_snippets/cloud/features/alerts-and-incidents/alert-types.mdx b/docs/snippets/cloud/features/alerts-and-incidents/alert-types.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/alerts-and-incidents/alert-types.mdx
rename to docs/snippets/cloud/features/alerts-and-incidents/alert-types.mdx
diff --git a/docs/_snippets/cloud/features/anomaly-detection/all-anomalies-configuration.mdx b/docs/snippets/cloud/features/anomaly-detection/all-anomalies-configuration.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/anomaly-detection/all-anomalies-configuration.mdx
rename to docs/snippets/cloud/features/anomaly-detection/all-anomalies-configuration.mdx
diff --git a/docs/_snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx b/docs/snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx
rename to docs/snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx
diff --git a/docs/_snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx b/docs/snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx
rename to docs/snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx
diff --git a/docs/_snippets/cloud/features/anomaly-detection/freshness-configuration.mdx b/docs/snippets/cloud/features/anomaly-detection/freshness-configuration.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/anomaly-detection/freshness-configuration.mdx
rename to docs/snippets/cloud/features/anomaly-detection/freshness-configuration.mdx
diff --git a/docs/_snippets/cloud/features/anomaly-detection/volume-configuration.mdx b/docs/snippets/cloud/features/anomaly-detection/volume-configuration.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/anomaly-detection/volume-configuration.mdx
rename to docs/snippets/cloud/features/anomaly-detection/volume-configuration.mdx
diff --git a/docs/_snippets/cloud/features/data-health/data-health-intro.mdx b/docs/snippets/cloud/features/data-health/data-health-intro.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/data-health/data-health-intro.mdx
rename to docs/snippets/cloud/features/data-health/data-health-intro.mdx
diff --git a/docs/_snippets/cloud/features/data-health/data-quality-dimensions.mdx b/docs/snippets/cloud/features/data-health/data-quality-dimensions.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/data-health/data-quality-dimensions.mdx
rename to docs/snippets/cloud/features/data-health/data-quality-dimensions.mdx
diff --git a/docs/_snippets/cloud/features/data-tests/benefits-dbt-tests.mdx b/docs/snippets/cloud/features/data-tests/benefits-dbt-tests.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/data-tests/benefits-dbt-tests.mdx
rename to docs/snippets/cloud/features/data-tests/benefits-dbt-tests.mdx
diff --git a/docs/_snippets/cloud/features/data-tests/data-tests-cards.mdx b/docs/snippets/cloud/features/data-tests/data-tests-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/data-tests/data-tests-cards.mdx
rename to docs/snippets/cloud/features/data-tests/data-tests-cards.mdx
diff --git a/docs/_snippets/cloud/features/data-tests/dbt-test-hub.mdx b/docs/snippets/cloud/features/data-tests/dbt-test-hub.mdx
similarity index 100%
rename from docs/_snippets/cloud/features/data-tests/dbt-test-hub.mdx
rename to docs/snippets/cloud/features/data-tests/dbt-test-hub.mdx
diff --git a/docs/_snippets/cloud/how-it-works.mdx b/docs/snippets/cloud/how-it-works.mdx
similarity index 100%
rename from docs/_snippets/cloud/how-it-works.mdx
rename to docs/snippets/cloud/how-it-works.mdx
diff --git a/docs/_snippets/cloud/integrations/athena.mdx b/docs/snippets/cloud/integrations/athena.mdx
similarity index 97%
rename from docs/_snippets/cloud/integrations/athena.mdx
rename to docs/snippets/cloud/integrations/athena.mdx
index aaa7e3460..8bbf98986 100644
--- a/docs/_snippets/cloud/integrations/athena.mdx
+++ b/docs/snippets/cloud/integrations/athena.mdx
@@ -1,6 +1,8 @@
+import CreateUserOperation from '/snippets/cloud/integrations/create-user-operation.mdx';
+
You will connect Elementary Cloud to Athena for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
## AWS Setup
diff --git a/docs/_snippets/cloud/integrations/bigquery.mdx b/docs/snippets/cloud/integrations/bigquery.mdx
similarity index 69%
rename from docs/_snippets/cloud/integrations/bigquery.mdx
rename to docs/snippets/cloud/integrations/bigquery.mdx
index 8e35e235e..6e56069c5 100644
--- a/docs/_snippets/cloud/integrations/bigquery.mdx
+++ b/docs/snippets/cloud/integrations/bigquery.mdx
@@ -1,8 +1,12 @@
+import CloudServiceAccount from '/snippets/dwh/bigquery/cloud_service_account.mdx';
+import PermissionsAndSecurity from '/snippets/cloud/integrations/permissions-and-security.mdx';
+import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx';
+
You will connect Elementary Cloud to Bigquery for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
-
+
### Fill the connection form
@@ -13,4 +17,4 @@ Provide the following fields:
- **Elementary dataset**: The name of your Elementary dataset. Usually `[dataset name]_elementary`.
- **Location**: Use this field to configure the location of BigQuery datasets as per [the BigQuery documentation](https://cloud.google.com/bigquery/docs/locations).
-
+
diff --git a/docs/_snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx
rename to docs/snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx
diff --git a/docs/_snippets/cloud/integrations/cards-groups/bi-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/bi-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/cards-groups/bi-cards.mdx
rename to docs/snippets/cloud/integrations/cards-groups/bi-cards.mdx
diff --git a/docs/snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx
new file mode 100644
index 000000000..f28a58ebc
--- /dev/null
+++ b/docs/snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx
@@ -0,0 +1,30 @@
+import ConnectDwhCards from '/snippets/cloud/integrations/cards-groups/connect-dwh-cards.mdx';
+import TransformationAndOrchestrationCards from '/snippets/cloud/integrations/cards-groups/transformation-and-orchestration-cards.mdx';
+import BiCards from '/snippets/cloud/integrations/cards-groups/bi-cards.mdx';
+import ReverseEtlCards from '/snippets/cloud/integrations/cards-groups/reverse-etl-cards.mdx';
+import CodeRepoCards from '/snippets/cloud/integrations/cards-groups/code-repo-cards.mdx';
+import AlertsDestinationCards from '/snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx';
+
+### Data warehouses
+
+
+
+### Transformation and orchestration
+
+
+
+### Data visualization
+
+
+
+### Reverse ETL
+
+
+
+### Code repositories
+
+
+
+### Alerts & incidents
+
+
\ No newline at end of file
diff --git a/docs/_snippets/cloud/integrations/cards-groups/code-repo-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/code-repo-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/cards-groups/code-repo-cards.mdx
rename to docs/snippets/cloud/integrations/cards-groups/code-repo-cards.mdx
diff --git a/docs/_snippets/cloud/integrations/cards-groups/connect-dwh-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/connect-dwh-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/cards-groups/connect-dwh-cards.mdx
rename to docs/snippets/cloud/integrations/cards-groups/connect-dwh-cards.mdx
diff --git a/docs/_snippets/cloud/integrations/cards-groups/reverse-etl-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/reverse-etl-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/cards-groups/reverse-etl-cards.mdx
rename to docs/snippets/cloud/integrations/cards-groups/reverse-etl-cards.mdx
diff --git a/docs/_snippets/cloud/integrations/cards-groups/transformation-and-orchestration-cards.mdx b/docs/snippets/cloud/integrations/cards-groups/transformation-and-orchestration-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/cards-groups/transformation-and-orchestration-cards.mdx
rename to docs/snippets/cloud/integrations/cards-groups/transformation-and-orchestration-cards.mdx
diff --git a/docs/_snippets/cloud/integrations/clickhouse.mdx b/docs/snippets/cloud/integrations/clickhouse.mdx
similarity index 79%
rename from docs/_snippets/cloud/integrations/clickhouse.mdx
rename to docs/snippets/cloud/integrations/clickhouse.mdx
index c9dfdf50a..21013479c 100644
--- a/docs/_snippets/cloud/integrations/clickhouse.mdx
+++ b/docs/snippets/cloud/integrations/clickhouse.mdx
@@ -1,6 +1,9 @@
+import CreateUserOperation from '/snippets/cloud/integrations/create-user-operation.mdx';
+import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx';
+
You will connect Elementary Cloud to Clickhouse for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
### Fill the connection form
@@ -12,7 +15,7 @@ Provide the following fields:
- **User**: The name of the for Elementary user.
- **Password**: The password associated with the provided user.
-
+
### Connect via SSH tunnel
diff --git a/docs/_snippets/cloud/integrations/create-user-operation-snowflake.mdx b/docs/snippets/cloud/integrations/create-user-operation-snowflake.mdx
similarity index 85%
rename from docs/_snippets/cloud/integrations/create-user-operation-snowflake.mdx
rename to docs/snippets/cloud/integrations/create-user-operation-snowflake.mdx
index 01aac8f02..2bf22da30 100644
--- a/docs/_snippets/cloud/integrations/create-user-operation-snowflake.mdx
+++ b/docs/snippets/cloud/integrations/create-user-operation-snowflake.mdx
@@ -1,3 +1,5 @@
+import PermissionsAndSecurity from '/snippets/cloud/integrations/permissions-and-security.mdx';
+
### Create a user for Elementary cloud
* Please create a Snowflake key-pair (private and public key) using [this](https://docs.snowflake.com/en/user-guide/key-pair-auth#configuring-key-pair-authentication) guide.
@@ -14,4 +16,4 @@ dbt run-operation create_elementary_user --args "{'public_key': '$SNOWFLAKE_PUBL
This command will generate a query to create a user with the necessary permissions. Run this query on your data warehouse with **admin permissions** to create the user.
-
+
diff --git a/docs/_snippets/cloud/integrations/create-user-operation.mdx b/docs/snippets/cloud/integrations/create-user-operation.mdx
similarity index 73%
rename from docs/_snippets/cloud/integrations/create-user-operation.mdx
rename to docs/snippets/cloud/integrations/create-user-operation.mdx
index bbc685a73..1d60ba049 100644
--- a/docs/_snippets/cloud/integrations/create-user-operation.mdx
+++ b/docs/snippets/cloud/integrations/create-user-operation.mdx
@@ -1,3 +1,5 @@
+import PermissionsAndSecurity from '/snippets/cloud/integrations/permissions-and-security.mdx';
+
### Create a user for Elementary cloud
On your dbt project, run:
@@ -9,4 +11,4 @@ dbt run-operation create_elementary_user
This command will generate a query to create a user with the necessary permissions. Run this query on your data warehouse with **admin permissions** to create the user.
-
+
diff --git a/docs/_snippets/cloud/integrations/databricks.mdx b/docs/snippets/cloud/integrations/databricks.mdx
similarity index 68%
rename from docs/_snippets/cloud/integrations/databricks.mdx
rename to docs/snippets/cloud/integrations/databricks.mdx
index 04dd98f97..10f447a3c 100644
--- a/docs/_snippets/cloud/integrations/databricks.mdx
+++ b/docs/snippets/cloud/integrations/databricks.mdx
@@ -1,8 +1,12 @@
+import CreateServicePrincipal from '/snippets/dwh/databricks/create_service_principal.mdx';
+import PermissionsAndSecurity from '/snippets/cloud/integrations/permissions-and-security.mdx';
+import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx';
+
You will connect Elementary Cloud to Databricks for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
-
+
### Fill the connection form
@@ -14,4 +18,4 @@ Provide the following fields:
- **Catalog (optional)**: The name of the Databricks Catalog.
- **Elementary schema**: The name of your Elementary schema. Usually `[schema name]_elementary`.
-
+
diff --git a/docs/_snippets/cloud/integrations/dremio.mdx b/docs/snippets/cloud/integrations/dremio.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/dremio.mdx
rename to docs/snippets/cloud/integrations/dremio.mdx
diff --git a/docs/_snippets/cloud/integrations/ip-allowlist.mdx b/docs/snippets/cloud/integrations/ip-allowlist.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/ip-allowlist.mdx
rename to docs/snippets/cloud/integrations/ip-allowlist.mdx
diff --git a/docs/_snippets/cloud/integrations/onboarding-help.mdx b/docs/snippets/cloud/integrations/onboarding-help.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/onboarding-help.mdx
rename to docs/snippets/cloud/integrations/onboarding-help.mdx
diff --git a/docs/_snippets/cloud/integrations/permissions-and-security.mdx b/docs/snippets/cloud/integrations/permissions-and-security.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/permissions-and-security.mdx
rename to docs/snippets/cloud/integrations/permissions-and-security.mdx
diff --git a/docs/_snippets/cloud/integrations/postgres.mdx b/docs/snippets/cloud/integrations/postgres.mdx
similarity index 81%
rename from docs/_snippets/cloud/integrations/postgres.mdx
rename to docs/snippets/cloud/integrations/postgres.mdx
index 9e7b7fd5f..741ad0b67 100644
--- a/docs/_snippets/cloud/integrations/postgres.mdx
+++ b/docs/snippets/cloud/integrations/postgres.mdx
@@ -1,6 +1,9 @@
+import CreateUserOperation from '/snippets/cloud/integrations/create-user-operation.mdx';
+import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx';
+
You will connect Elementary Cloud to Postgres for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
### Fill the connection form
@@ -13,7 +16,7 @@ Provide the following fields:
- **User**: The name of the for Elementary user.
- **Password**: The password associated with the provided user.
-
+
### Connect via SSH tunnel
diff --git a/docs/_snippets/cloud/integrations/redshift.mdx b/docs/snippets/cloud/integrations/redshift.mdx
similarity index 81%
rename from docs/_snippets/cloud/integrations/redshift.mdx
rename to docs/snippets/cloud/integrations/redshift.mdx
index 3604ce7a0..e220cbc7a 100644
--- a/docs/_snippets/cloud/integrations/redshift.mdx
+++ b/docs/snippets/cloud/integrations/redshift.mdx
@@ -1,6 +1,9 @@
+import CreateUserOperation from '/snippets/cloud/integrations/create-user-operation.mdx';
+import IpAllowlist from '/snippets/cloud/integrations/ip-allowlist.mdx';
+
You will connect Elementary Cloud to Redshift for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
### Fill the connection form
@@ -13,7 +16,7 @@ Provide the following fields:
- **User**: The name of the for Elementary user.
- **Password**: The password associated with the provided user.
-
+
### Connect via SSH tunnel
diff --git a/docs/_snippets/cloud/integrations/repo-connection-settings.mdx b/docs/snippets/cloud/integrations/repo-connection-settings.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/repo-connection-settings.mdx
rename to docs/snippets/cloud/integrations/repo-connection-settings.mdx
diff --git a/docs/_snippets/cloud/integrations/snowflake.mdx b/docs/snippets/cloud/integrations/snowflake.mdx
similarity index 94%
rename from docs/_snippets/cloud/integrations/snowflake.mdx
rename to docs/snippets/cloud/integrations/snowflake.mdx
index 6c2dea745..9248a2ef3 100644
--- a/docs/_snippets/cloud/integrations/snowflake.mdx
+++ b/docs/snippets/cloud/integrations/snowflake.mdx
@@ -1,6 +1,8 @@
+import CreateUserOperationSnowflake from '/snippets/cloud/integrations/create-user-operation-snowflake.mdx';
+
You will connect Elementary Cloud to Snowflake for syncing the Elementary schema (created by the [Elementary dbt package](/cloud/onboarding/quickstart-dbt-package)).
-
+
### Fill the connection form
diff --git a/docs/_snippets/cloud/integrations/trino.mdx b/docs/snippets/cloud/integrations/trino.mdx
similarity index 100%
rename from docs/_snippets/cloud/integrations/trino.mdx
rename to docs/snippets/cloud/integrations/trino.mdx
diff --git a/docs/_snippets/cloud/introduction-opening.mdx b/docs/snippets/cloud/introduction-opening.mdx
similarity index 100%
rename from docs/_snippets/cloud/introduction-opening.mdx
rename to docs/snippets/cloud/introduction-opening.mdx
diff --git a/docs/_snippets/cloud/introduction.mdx b/docs/snippets/cloud/introduction.mdx
similarity index 93%
rename from docs/_snippets/cloud/introduction.mdx
rename to docs/snippets/cloud/introduction.mdx
index dc6c95d3d..ebc05faaf 100644
--- a/docs/_snippets/cloud/introduction.mdx
+++ b/docs/snippets/cloud/introduction.mdx
@@ -1,3 +1,5 @@
+import CloudIntegrationsCards from '/snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx';
+
### Why choose Elementary Cloud?
@@ -40,7 +42,7 @@
### Elementary Cloud integrations
-
+
### How does it work?
diff --git a/docs/_snippets/cloud/quick-start-cards.mdx b/docs/snippets/cloud/quick-start-cards.mdx
similarity index 100%
rename from docs/_snippets/cloud/quick-start-cards.mdx
rename to docs/snippets/cloud/quick-start-cards.mdx
diff --git a/docs/_snippets/cloud/quickstart-steps.mdx b/docs/snippets/cloud/quickstart-steps.mdx
similarity index 100%
rename from docs/_snippets/cloud/quickstart-steps.mdx
rename to docs/snippets/cloud/quickstart-steps.mdx
diff --git a/docs/_snippets/column-metrics.mdx b/docs/snippets/column-metrics.mdx
similarity index 100%
rename from docs/_snippets/column-metrics.mdx
rename to docs/snippets/column-metrics.mdx
diff --git a/docs/_snippets/data-tests/tests-cards.mdx b/docs/snippets/data-tests/tests-cards.mdx
similarity index 100%
rename from docs/_snippets/data-tests/tests-cards.mdx
rename to docs/snippets/data-tests/tests-cards.mdx
diff --git a/docs/_snippets/dbt-18-materializations-common.mdx b/docs/snippets/dbt-18-materializations-common.mdx
similarity index 100%
rename from docs/_snippets/dbt-18-materializations-common.mdx
rename to docs/snippets/dbt-18-materializations-common.mdx
diff --git a/docs/_snippets/dwh/bigquery/cli_permissions.mdx b/docs/snippets/dwh/bigquery/cli_permissions.mdx
similarity index 100%
rename from docs/_snippets/dwh/bigquery/cli_permissions.mdx
rename to docs/snippets/dwh/bigquery/cli_permissions.mdx
diff --git a/docs/snippets/dwh/bigquery/cli_service_account.mdx b/docs/snippets/dwh/bigquery/cli_service_account.mdx
new file mode 100644
index 000000000..8b634e0d4
--- /dev/null
+++ b/docs/snippets/dwh/bigquery/cli_service_account.mdx
@@ -0,0 +1,7 @@
+import CreateServiceAccount from '/snippets/dwh/bigquery/create_service_account.mdx';
+import CliPermissions from '/snippets/dwh/bigquery/cli_permissions.mdx';
+import CreateKey from '/snippets/dwh/bigquery/create_key.mdx';
+
+
+
+
diff --git a/docs/_snippets/dwh/bigquery/cloud_permissions.mdx b/docs/snippets/dwh/bigquery/cloud_permissions.mdx
similarity index 100%
rename from docs/_snippets/dwh/bigquery/cloud_permissions.mdx
rename to docs/snippets/dwh/bigquery/cloud_permissions.mdx
diff --git a/docs/snippets/dwh/bigquery/cloud_service_account.mdx b/docs/snippets/dwh/bigquery/cloud_service_account.mdx
new file mode 100644
index 000000000..23ac51d6d
--- /dev/null
+++ b/docs/snippets/dwh/bigquery/cloud_service_account.mdx
@@ -0,0 +1,9 @@
+import CreateServiceAccount from '/snippets/dwh/bigquery/create_service_account.mdx';
+import CloudPermissions from '/snippets/dwh/bigquery/cloud_permissions.mdx';
+import CreateKey from '/snippets/dwh/bigquery/create_key.mdx';
+import GrantUserAccessOnDatasetLevel from '/snippets/dwh/bigquery/grant_user_access_on_dataset_level.mdx';
+
+
+
+
+
diff --git a/docs/_snippets/dwh/bigquery/create_key.mdx b/docs/snippets/dwh/bigquery/create_key.mdx
similarity index 100%
rename from docs/_snippets/dwh/bigquery/create_key.mdx
rename to docs/snippets/dwh/bigquery/create_key.mdx
diff --git a/docs/_snippets/dwh/bigquery/create_service_account.mdx b/docs/snippets/dwh/bigquery/create_service_account.mdx
similarity index 100%
rename from docs/_snippets/dwh/bigquery/create_service_account.mdx
rename to docs/snippets/dwh/bigquery/create_service_account.mdx
diff --git a/docs/_snippets/dwh/bigquery/grant_user_access_on_dataset_level.mdx b/docs/snippets/dwh/bigquery/grant_user_access_on_dataset_level.mdx
similarity index 100%
rename from docs/_snippets/dwh/bigquery/grant_user_access_on_dataset_level.mdx
rename to docs/snippets/dwh/bigquery/grant_user_access_on_dataset_level.mdx
diff --git a/docs/_snippets/dwh/databricks/create_service_principal.mdx b/docs/snippets/dwh/databricks/create_service_principal.mdx
similarity index 100%
rename from docs/_snippets/dwh/databricks/create_service_principal.mdx
rename to docs/snippets/dwh/databricks/create_service_principal.mdx
diff --git a/docs/_snippets/faq/question-change-elementary-schema.mdx b/docs/snippets/faq/question-change-elementary-schema.mdx
similarity index 100%
rename from docs/_snippets/faq/question-change-elementary-schema.mdx
rename to docs/snippets/faq/question-change-elementary-schema.mdx
diff --git a/docs/_snippets/faq/question-connection-profile.mdx b/docs/snippets/faq/question-connection-profile.mdx
similarity index 100%
rename from docs/_snippets/faq/question-connection-profile.mdx
rename to docs/snippets/faq/question-connection-profile.mdx
diff --git a/docs/_snippets/faq/question-cost.mdx b/docs/snippets/faq/question-cost.mdx
similarity index 100%
rename from docs/_snippets/faq/question-cost.mdx
rename to docs/snippets/faq/question-cost.mdx
diff --git a/docs/_snippets/faq/question-dbt-cloud.mdx b/docs/snippets/faq/question-dbt-cloud.mdx
similarity index 100%
rename from docs/_snippets/faq/question-dbt-cloud.mdx
rename to docs/snippets/faq/question-dbt-cloud.mdx
diff --git a/docs/_snippets/faq/question-disable-elementary-models.mdx b/docs/snippets/faq/question-disable-elementary-models.mdx
similarity index 100%
rename from docs/_snippets/faq/question-disable-elementary-models.mdx
rename to docs/snippets/faq/question-disable-elementary-models.mdx
diff --git a/docs/_snippets/faq/question-disable-hooks.mdx b/docs/snippets/faq/question-disable-hooks.mdx
similarity index 100%
rename from docs/_snippets/faq/question-disable-hooks.mdx
rename to docs/snippets/faq/question-disable-hooks.mdx
diff --git a/docs/_snippets/faq/question-elementary-permissions.mdx b/docs/snippets/faq/question-elementary-permissions.mdx
similarity index 100%
rename from docs/_snippets/faq/question-elementary-permissions.mdx
rename to docs/snippets/faq/question-elementary-permissions.mdx
diff --git a/docs/_snippets/faq/question-filter-elementary-tests.mdx b/docs/snippets/faq/question-filter-elementary-tests.mdx
similarity index 100%
rename from docs/_snippets/faq/question-filter-elementary-tests.mdx
rename to docs/snippets/faq/question-filter-elementary-tests.mdx
diff --git a/docs/_snippets/faq/question-full-refresh.mdx b/docs/snippets/faq/question-full-refresh.mdx
similarity index 100%
rename from docs/_snippets/faq/question-full-refresh.mdx
rename to docs/snippets/faq/question-full-refresh.mdx
diff --git a/docs/_snippets/faq/question-profile-permissions.mdx b/docs/snippets/faq/question-profile-permissions.mdx
similarity index 100%
rename from docs/_snippets/faq/question-profile-permissions.mdx
rename to docs/snippets/faq/question-profile-permissions.mdx
diff --git a/docs/_snippets/faq/question-schema-no-accordion.mdx b/docs/snippets/faq/question-schema-no-accordion.mdx
similarity index 100%
rename from docs/_snippets/faq/question-schema-no-accordion.mdx
rename to docs/snippets/faq/question-schema-no-accordion.mdx
diff --git a/docs/snippets/faq/question-schema.mdx b/docs/snippets/faq/question-schema.mdx
new file mode 100644
index 000000000..8e4533c8c
--- /dev/null
+++ b/docs/snippets/faq/question-schema.mdx
@@ -0,0 +1,7 @@
+import QuestionSchemaNoAccordion from '/snippets/faq/question-schema-no-accordion.mdx';
+
+
+
+
+
+
diff --git a/docs/_snippets/faq/question-singular-tests-config.mdx b/docs/snippets/faq/question-singular-tests-config.mdx
similarity index 100%
rename from docs/_snippets/faq/question-singular-tests-config.mdx
rename to docs/snippets/faq/question-singular-tests-config.mdx
diff --git a/docs/_snippets/faq/question-test-results-sample.mdx b/docs/snippets/faq/question-test-results-sample.mdx
similarity index 100%
rename from docs/_snippets/faq/question-test-results-sample.mdx
rename to docs/snippets/faq/question-test-results-sample.mdx
diff --git a/docs/_snippets/faq/question-tests-configuration-priorities.mdx b/docs/snippets/faq/question-tests-configuration-priorities.mdx
similarity index 100%
rename from docs/_snippets/faq/question-tests-configuration-priorities.mdx
rename to docs/snippets/faq/question-tests-configuration-priorities.mdx
diff --git a/docs/_snippets/faq/question-which-tests.mdx b/docs/snippets/faq/question-which-tests.mdx
similarity index 100%
rename from docs/_snippets/faq/question-which-tests.mdx
rename to docs/snippets/faq/question-which-tests.mdx
diff --git a/docs/_snippets/guides/alerts-code-configuration.mdx b/docs/snippets/guides/alerts-code-configuration.mdx
similarity index 96%
rename from docs/_snippets/guides/alerts-code-configuration.mdx
rename to docs/snippets/guides/alerts-code-configuration.mdx
index aab2625ab..339e73634 100644
--- a/docs/_snippets/guides/alerts-code-configuration.mdx
+++ b/docs/snippets/guides/alerts-code-configuration.mdx
@@ -1,3 +1,8 @@
+import Owner from '/snippets/alerts/owner.mdx';
+import Subscribers from '/snippets/alerts/subscribers.mdx';
+import Description from '/snippets/alerts/description.mdx';
+import Tags from '/snippets/alerts/tags.mdx';
+
You can enrich your alerts by adding properties to tests, models and sources in your `.yml` files.
The supported attributes are: [owner](#Owner),
[subscribers](#Subscribers),
@@ -45,19 +50,19 @@ Elementary prioritizes configuration in the following order:
#### Owner
-
+
#### Subscribers
-
+
#### Test description
-
+
#### Tags
-
+
### Alerts distribution
diff --git a/docs/_snippets/guides/collect-job-data.mdx b/docs/snippets/guides/collect-job-data.mdx
similarity index 100%
rename from docs/_snippets/guides/collect-job-data.mdx
rename to docs/snippets/guides/collect-job-data.mdx
diff --git a/docs/_snippets/guides/dbt-source-freshness.mdx b/docs/snippets/guides/dbt-source-freshness.mdx
similarity index 100%
rename from docs/_snippets/guides/dbt-source-freshness.mdx
rename to docs/snippets/guides/dbt-source-freshness.mdx
diff --git a/docs/_snippets/have-question.mdx b/docs/snippets/have-question.mdx
similarity index 100%
rename from docs/_snippets/have-question.mdx
rename to docs/snippets/have-question.mdx
diff --git a/docs/_snippets/install-cli.mdx b/docs/snippets/install-cli.mdx
similarity index 100%
rename from docs/_snippets/install-cli.mdx
rename to docs/snippets/install-cli.mdx
diff --git a/docs/_snippets/install-dbt-package.mdx b/docs/snippets/install-dbt-package.mdx
similarity index 100%
rename from docs/_snippets/install-dbt-package.mdx
rename to docs/snippets/install-dbt-package.mdx
diff --git a/docs/_snippets/oss/adapters-cards.mdx b/docs/snippets/oss/adapters-cards.mdx
similarity index 100%
rename from docs/_snippets/oss/adapters-cards.mdx
rename to docs/snippets/oss/adapters-cards.mdx
diff --git a/docs/_snippets/profiles/all-profiles.mdx b/docs/snippets/profiles/all-profiles.mdx
similarity index 100%
rename from docs/_snippets/profiles/all-profiles.mdx
rename to docs/snippets/profiles/all-profiles.mdx
diff --git a/docs/_snippets/profiles/bigquery-profile.mdx b/docs/snippets/profiles/bigquery-profile.mdx
similarity index 100%
rename from docs/_snippets/profiles/bigquery-profile.mdx
rename to docs/snippets/profiles/bigquery-profile.mdx
diff --git a/docs/_snippets/profiles/databricks-profile.mdx b/docs/snippets/profiles/databricks-profile.mdx
similarity index 100%
rename from docs/_snippets/profiles/databricks-profile.mdx
rename to docs/snippets/profiles/databricks-profile.mdx
diff --git a/docs/_snippets/profiles/redshift-profile.mdx b/docs/snippets/profiles/redshift-profile.mdx
similarity index 100%
rename from docs/_snippets/profiles/redshift-profile.mdx
rename to docs/snippets/profiles/redshift-profile.mdx
diff --git a/docs/_snippets/profiles/snowflake-profile.mdx b/docs/snippets/profiles/snowflake-profile.mdx
similarity index 100%
rename from docs/_snippets/profiles/snowflake-profile.mdx
rename to docs/snippets/profiles/snowflake-profile.mdx
diff --git a/docs/_snippets/quickstart-package-install.mdx b/docs/snippets/quickstart-package-install.mdx
similarity index 100%
rename from docs/_snippets/quickstart-package-install.mdx
rename to docs/snippets/quickstart-package-install.mdx
diff --git a/docs/_snippets/quickstart/quickstart-cards.mdx b/docs/snippets/quickstart/quickstart-cards.mdx
similarity index 100%
rename from docs/_snippets/quickstart/quickstart-cards.mdx
rename to docs/snippets/quickstart/quickstart-cards.mdx
diff --git a/docs/_snippets/quickstart/quickstart-elementary-prod.mdx b/docs/snippets/quickstart/quickstart-elementary-prod.mdx
similarity index 97%
rename from docs/_snippets/quickstart/quickstart-elementary-prod.mdx
rename to docs/snippets/quickstart/quickstart-elementary-prod.mdx
index 82ddb206c..682357f85 100644
--- a/docs/_snippets/quickstart/quickstart-elementary-prod.mdx
+++ b/docs/snippets/quickstart/quickstart-elementary-prod.mdx
@@ -1,3 +1,5 @@
+import QuestionSchema from '/snippets/faq/question-schema.mdx';
+
@@ -48,7 +50,7 @@ On your dbt project, make sure that Elementary dbt package can:
- Write to the elementary schema
- Create a schema (alternatively, you can create the elementary schema in advance)
-
+
## When to run Elementary?
diff --git a/docs/_snippets/setup-slack-integration.mdx b/docs/snippets/setup-slack-integration.mdx
similarity index 100%
rename from docs/_snippets/setup-slack-integration.mdx
rename to docs/snippets/setup-slack-integration.mdx
diff --git a/docs/_snippets/setup-teams-integration.mdx b/docs/snippets/setup-teams-integration.mdx
similarity index 100%
rename from docs/_snippets/setup-teams-integration.mdx
rename to docs/snippets/setup-teams-integration.mdx
diff --git a/docs/_snippets/share-report.mdx b/docs/snippets/share-report.mdx
similarity index 100%
rename from docs/_snippets/share-report.mdx
rename to docs/snippets/share-report.mdx
diff --git a/docs/_snippets/support-contact.mdx b/docs/snippets/support-contact.mdx
similarity index 100%
rename from docs/_snippets/support-contact.mdx
rename to docs/snippets/support-contact.mdx
diff --git a/docs/tutorial/installing-elementary.mdx b/docs/tutorial/installing-elementary.mdx
index 9dd9cc06d..c6cedc839 100644
--- a/docs/tutorial/installing-elementary.mdx
+++ b/docs/tutorial/installing-elementary.mdx
@@ -3,6 +3,10 @@ title: "Installing Elementary dbt Package"
sidebarTitle: "Install dbt package"
---
-
+import QuickstartPackageInstall from '/snippets/quickstart-package-install.mdx';
+
+
+
+
**Now, let's take a look at the artifacts that Elementary creates in our DWH.**
diff --git a/docs/tutorial/running-elementary.mdx b/docs/tutorial/running-elementary.mdx
index 709c6e74d..64f9ab853 100644
--- a/docs/tutorial/running-elementary.mdx
+++ b/docs/tutorial/running-elementary.mdx
@@ -3,6 +3,12 @@ title: "Running Elementary Tests and Generate Reports"
sidebarTitle: "Generate report"
---
+import InstallCli from '/snippets/install-cli.mdx';
+import AddConnectionProfile from '/snippets/add-connection-profile.mdx';
+import SupportContact from '/snippets/support-contact.mdx';
+
+
+
## Elementary CLI Setup
The CLI tool allows users to generate reports and visuallize results based on the tests we just configured. While we have already added the Elementary packages to our dbt project, the Elementary CLI requires a separate installation, as it is a Python tool.
@@ -15,11 +21,11 @@ The CLI tool allows users to generate reports and visuallize results based on th
Run one of the following commands based on your platform:
-
+
-
+
## Running Elementary
@@ -68,4 +74,4 @@ edr report
## Congratulations!
Congratulations, you successfully configured Elementary's tests and ran the report!
-
+