Docs-fixes-June-2

docs/_snippets/cloud/features.mdx

@@ -0,0 +1,81 @@
+
+### Detection & Coverage
+
+Elementary integrates powerful anomaly detection and dbt tests into a unified detection strategy.
+Effective detection of data issues requires a comprehensive approach,
+including both pipeline and data monitoring, validation tests,
+anomaly detection for unexpected behavior, and a single interface to manage it all at scale.
+
+<CardGroup cols={2}>
+  <Card title="Anomaly Detection" href="/features/anomaly-detection/monitors-overview">
+    ML-powered monitors automatically detect data quality issues.
+    Out-of-the-box for volume and freshness, and opt-in for data quality metrics.
+  </Card>
+  <Card title="Data Tests" href="/features/anomaly-detection/data-tests-overview">
+    Validate data and track the results of dbt tests, dbt packages tests (dbt-utils, dbt-expectations, elementary) and custom SQL tests.  
+  </Card>
+  <Card title="Schema Validation" href="/features/data-tests/schema-validation-test">
+    Validate there are no breaking changes in tables schema, JSON schema, and downstream exposures such as dashboards.  
+  </Card>
+  <Card title="Runs & Performance" href="/features/performance-monitoring/performance-monitoring">
+    Track failures and runs of jobs, models, and tests overtime.
+    Pipeline failures and performance issues can cause data incidents, and create unneceserry costs.
+  </Card>
+  <Card title="Code & UI Configuration">
+    Configure Elementary in code, or via the UI for non-technical users or for adding tests in bulk.
+    The platform opens PRs to your repo, saving hours of tedious YAML edits.
+  </Card>
+  <Card title="Test Recommendations">
+    Coming soon!
+  </Card>
+</CardGroup>
+
+### Triage & Response
+
+Detecting issues is just the first step to achieve data reliability.
+Elementary offers tools to create an effective response plan, for faster recovery.
+This includes investigating the root cause and impact of issues, communicating issues to the relevant people, assigning owners to fix issues, keeping track of open incidents and more.
+
+<CardGroup cols={2}>
+  <Card title="Data Lineage" href="/features/data-lineage/lineage">
+    Column-level lineage that spans through sources, models and BI tools, enriched with monitoring results. Enables granular root cause and impact analysis. 
+  </Card>
+  <Card title="Ownership" href="/features/data-governance/define-ownership">
+    Define clear ownership of data assets and enable owners to be informed and accountable for the health and status of their data.   
+  </Card>
+  <Card title="Actionable Alerts" href="/features/alerts-and-incidents/alerts-and-incidents-overview">
+    Distribute highly configurable alerts to different channels and integrations. 
+    Automatically tag owners, and enable setting status and assigns at the alert level.  
+  </Card>
+  <Card title="Automated Grouping">
+    Different failures related to the same issue are grouped automatically to a single incident.
+    This accelerates triage and response, and reduces alerts fautigue.  
+  </Card>
+  <Card title="Incident Management" href="/features/alerts-and-incidents/incident-management">
+    Manage all open incidents in a single interface, with a clear view of status and assignees.
+    Track historical incidents and high-level incidents metrics. 
+  </Card>
+</CardGroup>
+
+### Collaboration & Communication
+
+The data team doesn’t live in a silo - you have many stakeholders.
+The only way to improve data trust is by bringing in more team members, users and stakeholders to the data health process.
+Elementary fosters collaboration by allowing you to easily share and communicate the status of issues,
+the overall health of the data platform and progress made to improve it with the broader organization.
+
+<CardGroup cols={2}>
+  <Card title="Data Health Dashboard" href="/features/collaboration-and-communication/data-observability-dashboard">
+    Up to date dashboard with current status and trends of data issues. 
+    Share the dashboard with others, enable them to slice results and stay informed.
+  </Card>
+  <Card title="Assets Tags" href="/features/data-governance/leverage-tags">
+    Enable effective collaboration and communication by grouping related data assets and tests by business domains, data products, priority, etc.   
+  </Card>
+  <Card title="Data Catalog" href="/features/collaboration-and-communication/catalog">
+    Search and explore your datasets information - descriptions, columns, column descriptions, compiled code, datasets health and more.
+  </Card>
+  <Card title="Data Health Score">
+    Coming soon!
+  </Card>
+</CardGroup>

docs/_snippets/cloud/features/anomaly-detection/automated-monitors-cards.mdx

@@ -0,0 +1,10 @@
+<CardGroup cols={2}>
+<Card title="Automated Freshness" href="/features/anomaly-detection/automated-freshness">
+  Monitors updates to tables and how frequently a table is updated, 
+  and fails if there is an unexpected delay. 
+</Card>
+<Card title="Automated Volume" href="/features/anomaly-detection/automated-volume">
+  Monitors how many rows were added or removed to a table on each update,
+  and fails if there is an unexpected drop or spike in rows. 
+</Card>
+</CardGroup>

docs/_snippets/cloud/features/anomaly-detection/automated-monitors-intro.mdx

@@ -0,0 +1,5 @@
+Out-of-the-box ML-powered monitoring for freshness and volume issues on all production tables.
+The automated monitors feature provides broad coverage and detection of critical pipeline issues, without any configuration effort.
+
+These monitors track updates to tables, and will detect data delays, incomplete updates, and significant volume changes.
+Additionally, there will be no increase in compute costs as the monitors leverage only warehouse metadata (e.g. information schema, query history).

docs/_snippets/cloud/how-it-works.mdx

@@ -0,0 +1,12 @@
+1. You install the Elementary dbt package in your dbt project and configure it to write to it's own schema, the Elementary schema.
+2. The package writes test results, run results, logs and metadata to the Elementary schema.
+3. The cloud service only requires `read access` to the Elementary schema, not to schemas where your sensitive data is stored.
+4. The cloud service connects to sync the Elementary schema using an **encrypted connection** and a **static IP address** that you will need to add to your allowlist.
+
+<Frame>
+  <img
+    src="https://res.cloudinary.com/diuctyblm/image/upload/v1719157574/Cloud_platform_architecture_dogyrm.png"
+    alt="Elementary cloud security"
+    width="700"
+  />
+</Frame>

docs/_snippets/cloud/integrations/cards-groups/alerts-destination-cards.mdx

@@ -51,24 +51,21 @@
         <svg xmlns="http://www.w3.org/2000/svg" height="45" viewBox="0 0 80 80" width="45" fill="#25c151"><path d="M6.704 59.217H0v-33.65c0-3.455 1.418-5.544 2.604-6.704 2.63-2.58 6.2-2.656 6.782-2.656h10.546c3.765 0 5.93 1.52 7.117 2.8 2.346 2.553 2.372 5.853 2.32 6.73v12.687c0 3.662-1.496 5.828-2.733 6.988-2.553 2.398-5.93 2.45-6.73 2.424H6.704zm13.46-18.102c.36 0 1.367-.103 1.908-.62.413-.387.62-1.083.62-2.1v-13.02c0-.36-.077-1.315-.593-1.857-.5-.516-1.444-.62-2.166-.62h-10.6c-2.63 0-2.63 1.985-2.63 2.656v15.55zM57.296 4.783H64V38.46c0 3.455-1.418 5.544-2.604 6.704-2.63 2.58-6.2 2.656-6.782 2.656H44.068c-3.765 0-5.93-1.52-7.117-2.8-2.346-2.553-2.372-5.853-2.32-6.73V25.62c0-3.662 1.496-5.828 2.733-6.988 2.553-2.398 5.93-2.45 6.73-2.424h13.202zM43.836 22.9c-.36 0-1.367.103-1.908.62-.413.387-.62 1.083-.62 2.1v13.02c0 .36.077 1.315.593 1.857.5.516 1.444.62 2.166.62h10.598c2.656-.026 2.656-2 2.656-2.682V22.9z"/></svg>
     }
   ></Card>
+  <Card
+    title="Opsgenie"
+    href="/cloud/integrations/alerts/opsgenie"
+    icon={
+    <svg width="38px" height="38px" viewBox="-24.5 0 305 305" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" preserveAspectRatio="xMidYMid" fill="#000000"><g id="SVGRepo_bgCarrier" stroke-width="0"></g><g id="SVGRepo_tracerCarrier" stroke-linecap="round" stroke-linejoin="round"></g><g id="SVGRepo_iconCarrier"> <defs> <linearGradient x1="50%" y1="16.6199552%" x2="50%" y2="119.282511%" id="linearGradient-1"> <stop stop-color="#2684FF" offset="0%"> </stop> <stop stop-color="#0052CC" offset="82%"> </stop> </linearGradient> <linearGradient x1="41.179673%" y1="31.1603357%" x2="67.7136955%" y2="78.6783874%" id="linearGradient-2"> <stop stop-color="#2684FF" offset="0%"> </stop> <stop stop-color="#0052CC" offset="62%"> </stop> </linearGradient> </defs> <g> <circle fill="url(#linearGradient-1)" cx="127.996078" cy="76.0579131" r="76.0579131"> </circle> <path d="M121.515807,302.952652 C71.8432945,271.266206 30.5322167,228.083335 1.07656696,177.056341 C-0.0620320498,175.01097 -0.309636381,172.587443 0.391817304,170.354079 C1.09327099,168.120715 2.6820805,166.273968 4.78566922,165.246901 L62.3833377,136.980984 C66.4123421,135.016304 71.2746417,136.506664 73.5106445,140.391652 C102.630871,189.198451 145.690139,228.174512 197.147387,252.304221 C178.169747,271.425488 157.153981,288.409659 134.476348,302.952652 C130.510908,305.428568 125.481248,305.428568 121.515807,302.952652 Z" fill="url(#linearGradient-2)"> </path> <path d="M134.476348,302.952652 C184.155284,271.274027 225.468036,228.089405 254.915589,177.056341 C256.057132,175.016287 256.31102,172.597018 255.617868,170.364422 C254.924715,168.131826 253.345322,166.281735 251.24912,165.246901 L193.608818,136.980984 C189.579813,135.016304 184.717514,136.506664 182.481511,140.391652 C153.367402,189.203464 110.306398,228.181097 58.8447689,252.304221 C77.8108513,271.438283 98.8280892,288.423643 121.515807,302.952652 C125.481248,305.428568 130.510908,305.428568 134.476348,302.952652 Z" fill="#2684FF"> </path> </g> </g></svg>
+    }
+  >
+  </Card>
   <Card
     title="Webhooks"
     href="cloud/integrations/alerts/webhooks"
     icon="webhook"
     iconType="solid"
   >
   </Card>
-  <Card
-    title="Opsgenie"
-    href="https://tally.so/r/3N6DlW?integration=Opsgenie"
-    icon={
-    <svg width="52" height="28" viewBox="0 0 52 28" fill="none" xmlns="http://www.w3.org/2000/svg">
-    <path d="M0.749516 4.776C0.749516 3.944 0.929516 3.204 1.28952 2.556C1.64952 1.9 2.14952 1.392 2.78952 1.032C3.43752 0.664 4.16952 0.48 4.98552 0.48C5.98552 0.48 6.84152 0.743999 7.55352 1.272C8.26552 1.8 8.74152 2.52 8.98152 3.432H6.72552C6.55752 3.08 6.31752 2.812 6.00552 2.628C5.70152 2.444 5.35352 2.352 4.96152 2.352C4.32952 2.352 3.81752 2.572 3.42552 3.012C3.03352 3.452 2.83752 4.04 2.83752 4.776C2.83752 5.512 3.03352 6.1 3.42552 6.54C3.81752 6.98 4.32952 7.2 4.96152 7.2C5.35352 7.2 5.70152 7.108 6.00552 6.924C6.31752 6.74 6.55752 6.472 6.72552 6.12H8.98152C8.74152 7.032 8.26552 7.752 7.55352 8.28C6.84152 8.8 5.98552 9.06 4.98552 9.06C4.16952 9.06 3.43752 8.88 2.78952 8.52C2.14952 8.152 1.64952 7.644 1.28952 6.996C0.929516 6.348 0.749516 5.608 0.749516 4.776ZM14.2221 9.084C13.4301 9.084 12.7021 8.9 12.0381 8.532C11.3821 8.164 10.8581 7.652 10.4661 6.996C10.0821 6.332 9.89014 5.588 9.89014 4.764C9.89014 3.94 10.0821 3.2 10.4661 2.544C10.8581 1.888 11.3821 1.376 12.0381 1.008C12.7021 0.64 13.4301 0.456 14.2221 0.456C15.0141 0.456 15.7381 0.64 16.3941 1.008C17.0581 1.376 17.5781 1.888 17.9541 2.544C18.3381 3.2 18.5301 3.94 18.5301 4.764C18.5301 5.588 18.3381 6.332 17.9541 6.996C17.5701 7.652 17.0501 8.164 16.3941 8.532C15.7381 8.9 15.0141 9.084 14.2221 9.084ZM14.2221 7.212C14.8941 7.212 15.4301 6.988 15.8301 6.54C16.2381 6.092 16.4421 5.5 16.4421 4.764C16.4421 4.02 16.2381 3.428 15.8301 2.988C15.4301 2.54 14.8941 2.316 14.2221 2.316C13.5421 2.316 12.9981 2.536 12.5901 2.976C12.1901 3.416 11.9901 4.012 11.9901 4.764C11.9901 5.508 12.1901 6.104 12.5901 6.552C12.9981 6.992 13.5421 7.212 14.2221 7.212ZM29.2117 0.576V9H27.1597V3.948L25.2757 9H23.6197L21.7237 3.936V9H19.6717V0.576H22.0957L24.4597 6.408L26.7997 0.576H29.2117ZM32.7394 0.576V9H30.6874V0.576H32.7394ZM41.7624 9H39.7104L36.2784 3.804V9H34.2264V0.576H36.2784L39.7104 5.796V0.576H41.7624V9ZM48.8419 3.24C48.6899 2.96 48.4699 2.748 48.1819 2.604C47.9019 2.452 47.5699 2.376 47.1859 2.376C46.5219 2.376 45.9899 2.596 45.5899 3.036C45.1899 3.468 44.9899 4.048 44.9899 4.776C44.9899 5.552 45.1979 6.16 45.6139 6.6C46.0379 7.032 46.6179 7.248 47.3539 7.248C47.8579 7.248 48.2819 7.12 48.6259 6.864C48.9779 6.608 49.2339 6.24 49.3939 5.76H46.7899V4.248H51.2539V6.156C51.1019 6.668 50.8419 7.144 50.4739 7.584C50.1139 8.024 49.6539 8.38 49.0939 8.652C48.5339 8.924 47.9019 9.06 47.1979 9.06C46.3659 9.06 45.6219 8.88 44.9659 8.52C44.3179 8.152 43.8099 7.644 43.4419 6.996C43.0819 6.348 42.9019 5.608 42.9019 4.776C42.9019 3.944 43.0819 3.204 43.4419 2.556C43.8099 1.9 44.3179 1.392 44.9659 1.032C45.6139 0.664 46.3539 0.48 47.1859 0.48C48.1939 0.48 49.0419 0.724 49.7299 1.212C50.4259 1.7 50.8859 2.376 51.1099 3.24H48.8419ZM12.1553 27.084C11.5393 27.084 10.9873 26.984 10.4993 26.784C10.0113 26.584 9.61928 26.288 9.32328 25.896C9.03528 25.504 8.88328 25.032 8.86728 24.48H11.0513C11.0833 24.792 11.1913 25.032 11.3753 25.2C11.5593 25.36 11.7993 25.44 12.0953 25.44C12.3993 25.44 12.6393 25.372 12.8153 25.236C12.9913 25.092 13.0793 24.896 13.0793 24.648C13.0793 24.44 13.0073 24.268 12.8633 24.132C12.7273 23.996 12.5553 23.884 12.3473 23.796C12.1473 23.708 11.8593 23.608 11.4833 23.496C10.9393 23.328 10.4953 23.16 10.1513 22.992C9.80728 22.824 9.51128 22.576 9.26328 22.248C9.01528 21.92 8.89128 21.492 8.89128 20.964C8.89128 20.18 9.17528 19.568 9.74328 19.128C10.3113 18.68 11.0513 18.456 11.9633 18.456C12.8913 18.456 13.6393 18.68 14.2073 19.128C14.7753 19.568 15.0793 20.184 15.1193 20.976H12.8993C12.8833 20.704 12.7833 20.492 12.5993 20.34C12.4153 20.18 12.1793 20.1 11.8913 20.1C11.6433 20.1 11.4433 20.168 11.2913 20.304C11.1393 20.432 11.0633 20.62 11.0633 20.868C11.0633 21.14 11.1913 21.352 11.4473 21.504C11.7033 21.656 12.1033 21.82 12.6473 21.996C13.1913 22.18 13.6313 22.356 13.9673 22.524C14.3113 22.692 14.6073 22.936 14.8553 23.256C15.1033 23.576 15.2273 23.988 15.2273 24.492C15.2273 24.972 15.1033 25.408 14.8553 25.8C14.6153 26.192 14.2633 26.504 13.7993 26.736C13.3353 26.968 12.7873 27.084 12.1553 27.084ZM20.4741 27.084C19.6821 27.084 18.9541 26.9 18.2901 26.532C17.6341 26.164 17.1101 25.652 16.7181 24.996C16.3341 24.332 16.1421 23.588 16.1421 22.764C16.1421 21.94 16.3341 21.2 16.7181 20.544C17.1101 19.888 17.6341 19.376 18.2901 19.008C18.9541 18.64 19.6821 18.456 20.4741 18.456C21.2661 18.456 21.9901 18.64 22.6461 19.008C23.3101 19.376 23.8301 19.888 24.2061 20.544C24.5901 21.2 24.7821 21.94 24.7821 22.764C24.7821 23.588 24.5901 24.332 24.2061 24.996C23.8221 25.652 23.3021 26.164 22.6461 26.532C21.9901 26.9 21.2661 27.084 20.4741 27.084ZM20.4741 25.212C21.1461 25.212 21.6821 24.988 22.0821 24.54C22.4901 24.092 22.6941 23.5 22.6941 22.764C22.6941 22.02 22.4901 21.428 22.0821 20.988C21.6821 20.54 21.1461 20.316 20.4741 20.316C19.7941 20.316 19.2501 20.536 18.8421 20.976C18.4421 21.416 18.2421 22.012 18.2421 22.764C18.2421 23.508 18.4421 24.104 18.8421 24.552C19.2501 24.992 19.7941 25.212 20.4741 25.212ZM29.9077 27.084C29.1157 27.084 28.3877 26.9 27.7237 26.532C27.0677 26.164 26.5437 25.652 26.1517 24.996C25.7677 24.332 25.5757 23.588 25.5757 22.764C25.5757 21.94 25.7677 21.2 26.1517 20.544C26.5437 19.888 27.0677 19.376 27.7237 19.008C28.3877 18.64 29.1157 18.456 29.9077 18.456C30.6997 18.456 31.4237 18.64 32.0797 19.008C32.7437 19.376 33.2637 19.888 33.6397 20.544C34.0237 21.2 34.2157 21.94 34.2157 22.764C34.2157 23.588 34.0237 24.332 33.6397 24.996C33.2557 25.652 32.7357 26.164 32.0797 26.532C31.4237 26.9 30.6997 27.084 29.9077 27.084ZM29.9077 25.212C30.5797 25.212 31.1157 24.988 31.5157 24.54C31.9237 24.092 32.1277 23.5 32.1277 22.764C32.1277 22.02 31.9237 21.428 31.5157 20.988C31.1157 20.54 30.5797 20.316 29.9077 20.316C29.2277 20.316 28.6837 20.536 28.2757 20.976C27.8757 21.416 27.6757 22.012 27.6757 22.764C27.6757 23.508 27.8757 24.104 28.2757 24.552C28.6837 24.992 29.2277 25.212 29.9077 25.212ZM42.8933 27H40.8413L37.4093 21.804V27H35.3573V18.576H37.4093L40.8413 23.796V18.576H42.8933V27Z" fill="#F2386C"/>
-    </svg>
-    }
-  >
-    Click for details
-  </Card>
   <Card
     title="Jira"
     href="https://tally.so/r/3N6DlW?integration=Jira"

docs/_snippets/cloud/integrations/cards-groups/cloud-integrations-cards.mdx

@@ -18,6 +18,6 @@
 
 <Snippet file="cloud/integrations/cards-groups/code-repo-cards.mdx" />
 
-### Communication and collaboration
+### Alerts & incidents
 
 <Snippet file="cloud/integrations/cards-groups/alerts-destination-cards.mdx" />

docs/_snippets/cloud/integrations/snowflake.mdx

@@ -12,7 +12,7 @@ Provide the following fields:
 - **Elementary schema**: The name of your Elementary schema. Usually `[schema name]_elementary`.
 - **Role (optional)**: e.g. `ELEMENTARY_ROLE`.
 
-Elementary cloud supports the user password and key pair authentication connection methods.
+Elementary Cloud supports the user password and key pair authentication connection methods.
 
 - **User password**:
   - User: The user created for Elementary.

docs/_snippets/guides/collect-job-data.mdx

@@ -15,7 +15,7 @@ The goal is to provide context that is useful to triage and resolve data issues,
 - The ID of a specific run execution: `job_run_id`
 - Job run results URL: `job_run_url`
 
-## How Elementary collects jobs metadata?
+## How Elementary collects jobs metadata
 
 #### Environment variables
 
@@ -31,7 +31,7 @@ To configure `env_var` for your orchestrator, refer to your orchestrator's docs.
 
 Elementary also supports passing job metadata as dbt vars. If `env_var` and `var` exist, the `var` will be prioritized.
 
-To pass job data to elementary using `var`, use the `--vars` flag in your invocations:
+To pass job data to Elementary using `var`, use the `--vars` flag in your invocations:
 
 ```shell
 dbt run --vars '{"orchestrator": "Airflow", "job_name": "dbt_marketing_night_load"}'
@@ -57,7 +57,7 @@ The following default environment variables are supported out of the box:
 | Github actions | orchestrator<br/>job_run_id: `GITHUB_RUN_ID`<br/>job_url: generated from `GITHUB_SERVER_URL`, `GITHUB_REPOSITORY`, `GITHUB_RUN_ID`                                                                                                                               |
 | Airflow        | orchestrator                                                                                                                                                                                                                                                     |
 
-## What if I use dbt cloud + orchestrator?
+## What if I use dbt Cloud + orchestrator?
 
 By default, Elementary will collect the dbt cloud jobs info.
 If you wish to override that, change your dbt cloud invocations to pass the orchestrator job info using `--vars`:

docs/_snippets/guides/dbt-source-freshness.mdx

@@ -1,5 +1,5 @@
 Unlike dbt and Elementary tests, the results of the command `dbt source-freshness` are not automatically collected.
-You can collect the results using Elementary CLI tool. 
+You can collect the results using the Elementary CLI tool. 
 
 If dbt source freshness results are collected, they will be presented in the UI, and in alerts upon failure. 
 
@@ -21,7 +21,7 @@ This operation will upload the results to a table, and the execution of `edr mon
 - Note that `dbt source freshness` and `upload-source-freshness` needs to run from the same machine.
 - Note that `upload-source-freshness` requires passing `--project-dir` argument.
 
-#### dbt cloud users
+#### dbt Cloud users
 
-The results can't be collected from dbt cloud.
+The results can't be collected from dbt Cloud.
 Here is a [suggestion from an Elementary user](https://elementary-community.slack.com/archives/C02CTC89LAX/p1688113609829869) for a solution you can implement.

docs/cloud/features.mdx

@@ -0,0 +1,6 @@
+---
+title: "Platform features"
+icon: "browsers"
+---
+
+<Snippet file="cloud/features.mdx" />

docs/cloud/general/security-and-privacy.mdx

@@ -6,7 +6,7 @@ icon: "lock"
 
 ## Security highlights
 
-Our product is designed with security and compliance in mind.
+Our product is designed with security and privacy in mind.
 
 - Elementary Cloud does not have read access to raw data in your data warehouse.
 - Elementary Cloud only extracts and stores metadata, logs and aggregated metrics.

docs/cloud/guides/collect-job-data.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Collect jobs info from orchestrator"
+title: "Collect Jobs Info From Orchestrator"
 sidebarTitle: "Collect jobs data"
 ---