Merge branch 'current' into joellabes-devblog-environments

contributing/content-style-guide.md

@@ -495,6 +495,14 @@ dbt officially provides two command line tools for running dbt commands:
 - [dbt Cloud CLI](/docs/cloud/cloud-cli-installation) — This tool allows you to develop locally and execute dbt commands against your dbt Cloud development environment from your local command line.
 - [dbt Core](https://github.com/dbt-labs/dbt-core) — This open-source tool is designed for local installation, enabling you to use dbt Core on the command line and communicate with databases through adapters.
 
+Here are some examples of what to use and what to avoid: <br />
+
+✅ Set up in the dbt Cloud CLI or dbt Core<br />
+✅ Set up in the dbt Cloud CLI or dbt Core CLI<br />
+
+❌ Set up via dbt CLI<br />
+❌ Set up in dbt Cloud, **or** via the CLI<br />
+
 ### Terms to use or avoid
 
 Use industry-specific terms and research new/improved terminology. Also, refer to the Inclusive Language section of this style guide for inclusive and accessible language and style. 

website/docs/docs/build/sl-getting-started.md

@@ -84,14 +84,17 @@ If you're encountering some issues when defining your metrics or setting up the
 <summary>How are you storing my data?</summary>
 User data passes through the Semantic Layer on its way back from the warehouse. dbt Labs ensures security by authenticating through the customer's data warehouse. Currently, we don't cache data for the long term, but it might temporarily stay in the system for up to 10 minutes, usually less. In the future, we'll introduce a caching feature that allows us to cache data on our infrastructure for up to 24 hours.
 </details>
+
 <details>
 <summary>Is the dbt Semantic Layer open source?</summary>
-The dbt Semantic Layer is proprietary, however, some components of the dbt Semantic Layer are open source, like dbt-core and MetricFlow. <br /><br />dbt Cloud Developer or dbt Core users can define metrics in their project, including a local dbt Core project, using the dbt Cloud IDE or the MetricFlow CLI.  However, to experience the universal dbt Semantic Layer and access those metrics using the API or downstream tools, users will must be on a dbt Cloud <a href="https://www.getdbt.com/pricing/">Team or Enterprise plan.</a></details>
+The dbt Semantic Layer is proprietary; however, some components of the dbt Semantic Layer are open source, such as dbt-core and MetricFlow. <br /><br />dbt Cloud Developer or dbt Core users can define metrics in their project, including a local dbt Core project, using the dbt Cloud IDE, dbt Cloud CLI, or dbt Core CLI. However, to experience the universal dbt Semantic Layer and access those metrics using the API or downstream tools, users must be on a dbt Cloud <a href="https://www.getdbt.com/pricing/">Team or Enterprise</a> plan. <br /><br />Refer to <a href="https://docs.getdbt.com/docs/cloud/billing">Billing</a> for more information.
+</details>
+
 
 ## Next steps
 
 - [About MetricFlow](/docs/build/about-metricflow)
 - [Build your metrics](/docs/build/build-metrics-intro)
-- [Get started with the dbt Semantic Layer](/docs/use-dbt-semantic-layer/quickstart-sl)
 - [Available integrations](/docs/use-dbt-semantic-layer/avail-sl-integrations)
 - Demo on [how to define and query metrics with MetricFlow](https://www.loom.com/share/60a76f6034b0441788d73638808e92ac?sid=861a94ac-25eb-4fd8-a310-58e159950f5a)
+- [Billing](/docs/cloud/billing)

website/docs/docs/cloud/billing.md

@@ -11,9 +11,11 @@ dbt Cloud offers a variety of [plans and pricing](https://www.getdbt.com/pricing
 
 ## How does dbt Cloud pricing work?
 
-As a customer, you pay for the number of seats you have and the amount of usage consumed each month.  Seats are billed primarily on the amount of Developer and Read licenses purchased. Usage is based on the number of [Successful Models Built](#what-counts-as-a-successful-model-built) and, if purchased and used, Semantic Layer Query Units subject to reasonable usage. All billing computations are conducted in Coordinated Universal Time (UTC).
+As a customer, you pay for the number of seats you have and the amount of usage consumed each month.  Seats are billed primarily on the amount of Developer and Read licenses purchased. 
 
-### What counts as a seat license? 
+Usage is based on the number of [Successful Models Built](#what-counts-as-a-successful-model-built) and, if purchased and used, Semantic Layer [Queried Metrics](#what-counts-as-a-queried-metric) subject to reasonable usage. All billing computations are conducted in Coordinated Universal Time (UTC).
+
+### What counts as a seat license?
 
 There are three types of possible seat licenses:
 
@@ -37,47 +39,46 @@ Any models built in a dbt Cloud development environment (for example, via the ID
 | Seeds                                       | ❌                  |
 | Snapshots                                   | ❌                  |
 
-### What counts as a Query Unit?​
+### What counts as a Queried Metric?
 
-The dbt Semantic Layer, powered by MetricFlow, measures usage in distinct query units. Every successful request you make to render or run SQL to the Semantic Layer API counts as at least one query unit, even if no data is returned. If the query calculates or renders SQL for multiple metrics, each calculated metric will be counted as a query unit.
-If a request to run a query is not executed successfully in the data platform or if a query results in an error without completion, it is not counted as a query unit. Requests for metadata from the Semantic Layer are also not counted as query units.
+The dbt Semantic Layer, powered by MetricFlow, measures usage in distinct Queried Metrics.
 
-Examples of query units include:
+- Every successful request you make to render or run SQL to the Semantic Layer API counts as at least one queried metric, even if no data is returned. 
+- If the query calculates or renders SQL for multiple metrics, each calculated metric will be counted as a queried metric.
+- If a request to run a query is not executed successfully in the data platform or if a query results in an error without completion, it is not counted as a queried metric. 
+- Requests for metadata from the Semantic Layer are also not counted as queried metrics.
 
-Querying one metric, grouping by one dimension → 1 query unit 
+Examples of queried metrics include:
 
-```shell
-dbt sl query --metrics revenue --group_by metric_time
-```
-Querying one metric, grouping by two dimensions → 1 query unit 
+- Querying one metric, grouping by one dimension → 1 queried metric 
 
-```shell
-dbt sl query --metrics revenue --group_by metric_time,user__country
-```
+  ```shell
+  dbt sl query --metrics revenue --group_by metric_time
+  ```
 
-Querying two metrics, grouping by two dimensions → 2 query units 
+- Querying one metric, grouping by two dimensions → 1 queried metric 
 
-```shell
-dbt sl query --metrics revenue,gross_sales --group_by metric_time,user__country
-```
+  ```shell
+  dbt sl query --metrics revenue --group_by metric_time,user__country
+  ```
 
-Running an explain for one metric → 1 query unit
+- Querying two metrics, grouping by two dimensions → 2 queried metrics 
 
-```shell
-dbt sl query --metrics revenue --group_by metric_time --explain
-```
+  ```shell
+  dbt sl query --metrics revenue,gross_sales --group_by metric_time,user__country
+  ```
 
-Running an explain for two metrics → 2 query units
+- Running an explain for one metric → 1 queried metric
 
-```shell
-dbt sl query --metrics revenue,gross_sales --group_by metric_time --explain
-```
+  ```shell
+  dbt sl query --metrics revenue --group_by metric_time --explain
+  ```
 
-Running a query for only dimensions such as dimension_values or a query with no metrics → 1 query unit
+- Running an explain for two metrics → 2 queried metrics
 
-```shell
-bt sl list dimension-values --dimension user__country
-```
+  ```shell
+  dbt sl query --metrics revenue,gross_sales --group_by metric_time --explain
+  ```
 
 ### Viewing usage in the product 
 
@@ -94,7 +95,7 @@ On each Project Home page, any user with access to that project can see how many
 
 In addition, you can look at the Job Details page's Insights tab to show how many models are being built per month for that particular job and which models are taking the longest to build. 
 
-Any usage data is only an estimate of your usage, and there may be a delay in showing usage data in the product — your final usage for the month will be visible on your monthly statements (statements applicable to Team and Enterprise plans).
+Usage information is available to customers on consumption-based plans, and some usage visualizations might not be visible to customers on legacy plans. Any usage data shown in dbt Cloud is only an estimate of your usage, and there could be a delay in showing usage data in the product. Your final usage for the month will be visible on your monthly statements (statements applicable to Team and Enterprise plans).
 
 
 ## Plans and Billing
@@ -253,8 +254,7 @@ _Yes. Your dbt Cloud account will be upgraded without impacting your existing pr
  _The best option is to consult with our sales team. They'll help you figure out what is right for your needs. We also offer a free two-week trial on the Team plan._
 
 * What are the Semantic Layer trial terms?
-_Team and Enterprise customers can sign up for a free trial of the dbt Semantic Layer, powered by MetricFlow, for use of up to 1,000 query units per month. The trial will be available at least through January 2024. dbt Labs may extend the trial period in its sole discretion. During the trial period, we may reach out to discuss pricing options or ask for feedback. At the end of the trial, free access may be removed and a purchase may be required to continue use. dbt Labs reserves the right to change limits in a free trial or institute pricing when required or at any time in its sole discretion._
+_Team and Enterprise customers can sign up for a free trial of the dbt Semantic Layer, powered by MetricFlow, for use of up to 1,000 Queried Metrics per month. The trial will be available at least through January 2024. dbt Labs may extend the trial period in its sole discretion. During the trial period, we may reach out to discuss pricing options or ask for feedback. At the end of the trial, free access may be removed and a purchase may be required to continue use. dbt Labs reserves the right to change limits in a free trial or institute pricing when required or at any time in its sole discretion._
 
 * What is the reasonable use limitation for the dbt Semantic Layer powered by MetricFlow during the trial? 
 _Each account will be limited to 1,000 Queried Metrics per month during the trial period and may be changed at the sole discretion of dbt Labs._
-