elementary-data · haritamar · May 12, 2024 · Dec 14, 2023 · Feb 29, 2024 · Jan 15, 2024
diff --git a/.github/workflows/test-github-action.yml b/.github/workflows/test-github-action.yml
@@ -109,7 +109,7 @@ jobs:
       always() &&
       ! cancelled() &&
       ! contains(needs.test.result, 'success') &&
-      ! contains(needs.test.result, 'cancelled')
+      ! contains(needs.test.result, 'cancelled') &&
       ${{ github.event_name == 'schedule' }}
     uses: ./.github/workflows/notify_slack.yml
     with:

diff --git a/.github/workflows/test-warehouse.yml b/.github/workflows/test-warehouse.yml
@@ -114,7 +114,7 @@ jobs:
 
       - name: Install dbt
         run: >
-          pip install --pre
+          pip install
           "dbt-core${{ inputs.dbt-version && format('=={0}', inputs.dbt-version) }}"
           "dbt-${{ (inputs.warehouse-type == 'databricks_catalog' && 'databricks') || inputs.warehouse-type }}${{ inputs.dbt-version && format('<={0}', inputs.dbt-version) }}"
 

diff --git a/.gitignore b/.gitignore
@@ -27,6 +27,8 @@ var/
 *.mypy_cache/
 logs/
 .venv
+poetry.lock
+package-lock.yml
 
 # PyInstaller
 #  Usually these files are written by a python script from a template

diff --git a/README.md b/README.md
@@ -5,9 +5,6 @@
 <h2 align="center">
  dbt native data observability for analytics & data engineers
 </h2>
-<h4 align="center">
-Monitor your data quality, operation and performance directly from your dbt project.
-</h4>
 
 <p align="center">
 <a href="https://www.elementary-data.com/community"><img src="https://img.shields.io/badge/join-Slack-ff69b4"/></a>
@@ -25,77 +22,85 @@ Monitor your data quality, operation and performance directly from your dbt proj
 
 ## What is Elementary?
 
-Elementary is an open-source data observability solution, built for dbt users. Setup in minutes, gain immediate visibility, detect data issues, send actionable alerts, and understand impact and root cause.
+Elementary is a dbt-native data observability solution for data and analytics engineers.
+Set up in minutes, gain immediate visibility, detect data issues, send actionable alerts, and understand impact and root cause.
+Available as self-hosted or Cloud service with premium features.
+
+#### Table of Contents
+
+- [Features](#features)
+- [Self-hosted vs. Cloud service](#self-hosted-vs-cloud)
+- [Get Started](#get-started)
+- [Community & Support](#community--support)
+- [Contribution](#contributions)
 
 <kbd align="center">
         <a href="https://storage.googleapis.com/elementary_static/elementary_demo.html"><img align="center" style="max-width:300px;" src="static/report_ui.gif"> </a>
 </kbd>
 
 <br>
 
-## Quick start
+## Features
 
-Step 1 - [Install Elementary dbt package](https://docs.elementary-data.com/quickstart)
+<img src="static/happy_fire.ico" width="16"/> **Anomaly detection tests** - Collect data quality metrics and detect anomalies, as native dbt tests.
 
-Step 2 - [Install Elementary CLI](https://docs.elementary-data.com/quickstart-cli)
+<img src="static/happy_fire.ico" width="16"/> **Automated monitors** - Out-of-the-box cloud monitors to detect freshness, volume and schema issues.
 
-## Features
+<img src="static/happy_fire.ico" width="16"/> **End-to-End Data Lineage** - Enriched with the latest test results, for impact and root cause analysis of data issues. Elementary Cloud offers **Column Level Lineage** and **BI integrations**.
 
-<img src="static/happy_fire.ico" width="16"/> **Data observability report** - Generate a data observability report, host it or share with your team.
+<img src="static/happy_fire.ico" width="16"/> **Data quality dashboard** - Single interface for all your data monitoring and test results.
 
-<img src="static/happy_fire.ico" width="16"/> **Anomaly detection dbt tests** - Collect data quality metrics and detect anomalies, as native dbt tests.
+<img src="static/happy_fire.ico" width="16"/> **Models performance** - Monitor models and jobs run results and performance over time.
 
-<img src="static/happy_fire.ico" width="16"/> **Test results** - Enriched with details for fast triage of issues.
+<img src="static/happy_fire.ico" width="16"/> **Configuration-as-code** - Elementary configuration is managed in your dbt code.
 
-<img src="static/happy_fire.ico" width="16"/> **Models performance** - Visibility of execution times, easy detection of degradation and bottlenecks.
+<img src="static/happy_fire.ico" width="16"/> **Alerts** - Actionable alerts including custom channels and tagging of owners.
 
-<img src="static/happy_fire.ico" width="16"/> **Data lineage** - Enriched with test results, easy to navigate and filter.
+<img src="static/happy_fire.ico" width="16"/> **Data catalog** - Explore your datasets information - descriptions, columns, datasets health, etc.
 
 <img src="static/happy_fire.ico" width="16"/> **dbt artifacts uploader** - Save metadata and run results as part of your dbt runs.
 
-<img src="static/happy_fire.ico" width="16"/> **Slack alerts** - Actionable alerts, including custom channels and tagging of owners and subscribers.
-
 ##
 
-Join [Slack](https://www.elementary-data.com/community) to learn more on Elementary.
-
 Our full documentation is [available here](https://docs.elementary-data.com/).
 
-## How it works?
+Join [Slack](https://www.elementary-data.com/community) to learn more about Elementary.
 
-Elementary [dbt package](https://github.com/elementary-data/dbt-data-reliability) creates tables of metadata and test results in your data warehouse, as part of your dbt runs. The CLI tool reads the data from these tables, and is used to generate the UI and alerts.
+## Self-hosted vs. Cloud
 
-<img align="center" style="max-width:300px;" src="static/how_elementary_works.png">
+### Elementary Cloud
 
-## Community & Support
+Ideal for teams monitoring mission-critical data pipelines, requiring guaranteed uptime and reliability, short-time-to-value, advanced features, collaboration, and professional support.
+The solution is secure by design, and requires no access to your data from cloud.
 
-For additional information and help, you can use one of these channels:
+To learn more, [book a demo](https://cal.com/maayansa/elementary-intro-github) or see our [pricing page](https://www.elementary-data.com/pricing).
 
-- [Slack](https://www.elementary-data.com/community) \(Live chat with the team, support, discussions, etc.\)
-- [GitHub issues](https://github.com/elementary-data/elementary/issues) \(Bug reports, feature requests)
-- [Twitter](https://twitter.com/ElementaryData) \(Updates on new releases and stuff)
+### Self-hosted
 
-## **Integrations**
+Elementary Community is an open-source CLI tool you can deploy and orchestrate to send Slack alerts and self-host the Elementary report. It is best for data and analytics engineers that require basic observability capabilities or for evaluating features without vendor approval. Our community can provide great support on [Slack](https://www.elementary-data.com/community) if needed.
 
-- [x] **dbt core (>=1.0.0)** ![](static/dbt-16.png)
-- [x] **dbt cloud** ![](static/dbt-16.png)
+## Get Started
 
-**Data warehouses:**
+### Elementary Cloud
 
-- [x] **Snowflake** ![](static/snowflake-16.png)
-- [x] **BigQuery** ![](static/bigquery-16.svg)
-- [x] **Redshift** ![](static/redshift-16.png)
-- [x] **Databricks SQL** ![](static/databricks-16.png)
-- [x] **Postgres** ![](static/postgres-16.png)
+1 - [Create an account](https://elementary-data.frontegg.com/oauth/account/sign-up)
 
-**Operations:**
+2 - [Install Elementary dbt package](https://docs.elementary-data.com/cloud/onboarding/quickstart-dbt-package)
 
-- [x] **Slack** ![](static/slack-16.png)
-- [x] **GitHub Actions** ![](static/github-actions-16.png)
-- [x] **Amazon S3** ![](static/s3-16.svg)
-- [x] **Google Cloud Storage** ![](static/gcs-16.png)
+3 - [Connect Elementary Cloud](https://docs.elementary-data.com/cloud/onboarding/signup)
 
-Ask us for integrations on [Slack](https://www.elementary-data.com/community) or as a [GitHub issue](https://github.com/elementary-data/elementary-lineage/issues/new).
+### Elementary Community
+
+1 - [Install Elementary dbt package](https://docs.elementary-data.com/quickstart)
+
+2 - [Install Elementary CLI](https://docs.elementary-data.com/quickstart-cli)
+
+## Community & Support
+
+For additional information and help, you can use one of these channels:
+
+- [Slack community](https://www.elementary-data.com/community) \(Release announcements, community support, discussions, etc.\)
+- [GitHub issues](https://github.com/elementary-data/elementary/issues) \(Bug reports, feature requests)
 
 ## **Contributions**
 
@@ -196,6 +201,11 @@ Check out the [contributions guide](https://docs.elementary-data.com/general/con
 <a href="https://github.com/suelai"><img src="https://avatars.githubusercontent.com/u/24508576?v=4" width="50" height="50" alt=""/></a>
 <a href="https://github.com/aibazhang"><img src="https://avatars.githubusercontent.com/u/29817697?v=4" width="50" height="50" alt=""/></a>
 <a href="https://github.com/samirS97"><img src="https://avatars.githubusercontent.com/u/51163297?v=4" width="50" height="50" alt=""/></a>
+<a href="https://github.com/svdimchenko"><img src="https://avatars.githubusercontent.com/u/39801237?v=4" width="50" height="50" alt=""/></a>
+<a href="https://github.com/ronisaban2024"><img src="https://avatars.githubusercontent.com/u/162031979?v=4" width="50" height="50" alt=""/></a>
+<a href="https://github.com/dongchris"><img src="https://avatars.githubusercontent.com/u/86695140?v=4" width="50" height="50" alt=""/></a>
+<a href="https://github.com/sanromeo"><img src="https://avatars.githubusercontent.com/u/44975602?v=4" width="50" height="50" alt=""/></a>
+<a href="https://github.com/AvivZikelDY"><img src="https://avatars.githubusercontent.com/u/111749106?v=4" width="50" height="50" alt=""/></a>
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->

diff --git a/docs/_snippets/alerts/alerts-configuration.mdx b/docs/_snippets/alerts/alerts-configuration.mdx
@@ -0,0 +1,8 @@
+<CardGroup cols={2}>
+  <Card title="Alerts rules" icon="cloud" iconType="solid" href="/cloud/guides/alert-rules">
+    Use Alert Rules to distribute your alerts to the right channels.
+  </Card>
+  <Card title="Alerts configuration in code" icon="code" iconType="solid" href="/cloud/guides/alerts-configuration">
+    Alert content and properties configuration as code in your project YML files.
+  </Card>
+</CardGroup>
diff --git a/docs/_snippets/alerts/alerts-introduction.mdx b/docs/_snippets/alerts/alerts-introduction.mdx
@@ -1,18 +1,15 @@
 Elementary can send alerts about:
 
-- Failures and/or of dbt tests
-- Failures and/or Elementary tests
+- Failures and/or warnings of dbt tests
+- Failures and/or warnings Elementary tests
 - Model runs failures
-- Source freshness issues
-
-The alerts can be sent to Slack or Microsoft Teams, and we are working on adding more channels.
-Please [reach out to us](https://elementary-data.com/community) if you have a specific destination in mind.
+- Source freshness failures
 
 You can enrich your alerts by adding properties to tests and models in your `.yml` files.
 The supported attributes are: owner, subscribers, description, tags.
 
 You can configure and customize your alerts by configuring:
-custom channel, suppression interval, alert fields (for test alerts only), alert grouping, alert filters.
+Custom channel, suppression interval, alert filters, etc.
 
 <Frame>
   <div className="dark:bg-white rounded-md p-4">