dbt-labs · mirnawong1 · Aug 3, 2023 · Jul 17, 2023 · Jul 17, 2023 · Jul 17, 2023
@@ -183,6 +183,22 @@ exports.versionedPages = [
     "page": "docs/build/ratio",
     "firstVersion": "1.6",
   },
+  {
+    "category": "docs/use-dbt-semantic-layer/sl-api-overview",
+    "firstVersion": "1.6",
+  },
+	{
+    "category": "docs/use-dbt-semantic-layer/graphql",
+    "firstVersion": "1.6",
+  },
+	{
+    "category": "docs/use-dbt-semantic-layer/jdbc",
+    "firstVersion": "1.6",
+  },
+  {
+    "category": "docs/use-dbt-semantic-layer/sl-manifest",
+    "firstVersion": "1.6",
+  },
 ]
 
 exports.versionedCategories = [

@@ -10,7 +10,7 @@ This guide introduces MetricFlow's fundamental ideas for new users. MetricFlow,
 
 :::info
 
-MetricFlow is a new way to define metrics in dbt and one of the key components of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-semantic-layer). It handles SQL query construction and defines the specification for dbt semantic models and metrics. 
+MetricFlow is a new way to define metrics in dbt and one of the key components of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl). It handles SQL query construction and defines the specification for dbt semantic models and metrics. 
 
 To fully experience the dbt Semantic Layer, including the ability to query dbt metrics via external integrations, you'll need a [dbt Cloud Team or Enterprise account](https://www.getdbt.com/pricing/).
 

@@ -7,7 +7,7 @@ tags: [Metrics, Semantic Layer, Governance]
 hide_table_of_contents: true
 ---
 
-Use MetricFlow in dbt to centrally define your metrics. MetricFlow is a key component of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-semantic-layer) and is responsible for SQL query construction and defining specifications for dbt semantic models and metrics.
+Use MetricFlow in dbt to centrally define your metrics. MetricFlow is a key component of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and is responsible for SQL query construction and defining specifications for dbt semantic models and metrics.
 
 Use familiar constructs like semantic models and metrics to avoid duplicative coding, optimize your development workflow, ensure data governance for company metrics, and guarantee consistency for data consumers.
 
@@ -25,31 +25,44 @@ Before you start, keep the following considerations in mind:
   * Note: Support for BigQuery, Databricks, and Redshift coming soon.
 - dbt Labs is working with [integration partners](https://www.getdbt.com/product/semantic-layer-integrations) to develop updated integrations for the new Semantic Layer, powered by MetricFlow, in addition to introducing other consumption methods like Python and JDBC. <br /><br />
 
-<div className="grid--4-col">
+<div className="grid--3-col">
 
 <Card
     title="About MetricFlow"
     body="Understand MetricFlow's core concepts, key principles, and how to use this powerful tool."
     link="/docs/build/about-metricflow"
-    icon="rocket"/>
-
-<Card
-    title="Get started with MetricFlow"
-    body="Learn how to create a semantic model, a metric, and test and upload your metric using MetricFlow."
-    link="/docs/build/sl-getting-started"
-    icon="rocket"/>
+    icon="dbt-bit"/>
 
   <Card
     title="Semantic model"
-    body="Use Semantic models as the basis for defining data. They act as nodes in the semantic graph, with entities connecting them."
+    body="Use semantic models as the basis for defining data. They act as nodes in the semantic graph, with entities connecting them."
     link="/docs/build/semantic-models"
-    icon="rocket"/>
+    icon="dbt-bit"/>
 
   <Card
     title="Metrics"
     body="Define metrics through the powerful combination of measures, constraints, or functions, effortlessly organized in either YAML files or separate files."
     link="/docs/build/metrics-overview"
-    icon="rocket"/>   
+    icon="dbt-bit"/>
+
+ <Card
+    title="Get started with the dbt Semantic Layer"
+    body="Use this guide to build and define metrics, set up the dbt Semantic Layer, and query them using the Semantic Layer APIs"
+    link="/docs/use-dbt-semantic-layer/quickstart-sl"
+    icon="dbt-bit"/>
+
+  <Card
+    title="About the dbt Semantic Layer"
+    body="Introducing the dbt Semantic Layer, the universal process that allows data teams to centrally define and query metrics"
+    link="/docs/use-dbt-semantic-layer/dbt-sl"
+    icon="dbt-bit"/>
+
+  <Card
+    title="Available integrations"
+    body="Discover the diverse range of partners that seamlessly integrate with the powerful dbt Semantic Layer, allowing you to query and unlock valuable insights from your data ecosystem."
+    link="/docs/use-dbt-semantic-layer/avail-sl-integrations"
+    icon="dbt-bit"/>
+
 
 </div> <br />
 

@@ -6,23 +6,9 @@ keywords:
   - dbt metrics layer
 ---
 
-<VersionBlock firstVersion="1.6">
-
-:::info dbt Metrics isn't supported
-
-dbt Metrics is no longer supported in v1.6 and higher. To build your semantic layer, define and query metrics, and provide data governance - refer to [Build your Semantic Layer](/docs/build/build-metrics-intro) for updated guidance.
-
-:::
-</VersionBlock>
-
-<VersionBlock lastVersion="1.5">
-
-:::info dbt Metrics not recommended
-
-dbt Metrics won't be supported in v1.6 and higher, and is being replaced with MetricFlow. [Defining metrics](/docs/build/build-semantic-layer-intro) with MetricFlow will help shape the future of the dbt Semantic Layer &mdash; let us know [your thoughts and join the convo](https://github.com/dbt-labs/dbt-core/discussions/7456) to help build it!
-
-:::
+import LegacyInfo from '/snippets/_legacy-sl-callout.md';
 
+<LegacyInfo />
 
 <Changelog>
 
@@ -31,6 +17,7 @@ dbt Metrics won't be supported in v1.6 and higher, and is being replaced with Me
 
 </Changelog>
 
+<VersionBlock lastVersion="1.5">
 
 A metric is an aggregation over a <Term id="table" /> that supports zero or more dimensions. Some examples of metrics include:
 - active users
@@ -218,9 +205,12 @@ Metrics can have many declared **properties**, which define aspects of your metr
 ### Available calculation methods
 
 <VersionBlock firstVersion="1.3">
+
 The method of calculation (aggregation or derived) that is applied to the expression.
 </VersionBlock> 
+
 <VersionBlock lastVersion="1.2">
+
 The type of calculation (aggregation or expression) that is applied to the sql property.
 </VersionBlock> 
 
@@ -541,6 +531,7 @@ The period to date secondary calculation performs an aggregation on a defined pe
 #### Rolling:
 
 <VersionBlock firstVersion="1.3" >
+
 The rolling secondary calculation performs an aggregation on a number of rows in metric dataset. For example, if the user selects the `week` grain and sets a rolling secondary calculation to `4` then the value returned will be a rolling 4 week calculation of whatever aggregation type was selected. If the `interval` input is not provided then the rolling caclulation will be unbounded on all preceding rows.
 
 | Input                      | Example | Description | Required |
@@ -552,6 +543,7 @@ The rolling secondary calculation performs an aggregation on a number of rows in
 </VersionBlock>
 
 <VersionBlock lastVersion="1.2" >
+
 The rolling secondary calculation performs an aggregation on a number of rows in the metric dataset. For example, if the user selects the `week` grain and sets a rolling secondary calculation to `4`, then the value returned will be a rolling 4-week calculation of whatever aggregation type was selected.
 
 | Input                      | Example | Description | Required |
@@ -715,4 +707,6 @@ The above example will return a dataset that contains the metric provided in the
 </VersionBlock>
 
 <Snippet path="discourse-help-feed-header" />
+
 <DiscourseHelpFeed tags="metrics"/>
+
@@ -126,6 +126,7 @@ ANY COMMON TROUBLESHOOTING QUESTIONS?-->
 
 ## Related docs
 
+- [Get started with the dbt Semantic Layer](/docs/use-dbt-semantic-layer/quickstart-sl)
 - [The dbt Semantic Layer: what’s next](https://www.getdbt.com/blog/dbt-semantic-layer-whats-next/) blog post
 - [About MetricFlow](/docs/build/about-metricflow)
 - [Semantic models](/docs/build/semantic-models)

@@ -63,7 +63,7 @@ link="/docs/cloud/dbt-cloud-ide/develop-in-the-cloud"
    <Card
     title="dbt Semantic Layer*"
     body="Use the dbt Semantic Layer to define metrics alongside your dbt models and query them from any integrated analytics tool. Get the same answers everywhere, every time."
-    link="/docs/use-dbt-semantic-layer/dbt-semantic-layer"
+    link="/docs/use-dbt-semantic-layer/dbt-sl"
     icon="pencil-paper"/>  
 
    <Card

@@ -8,10 +8,11 @@ id: "overview"
 
 Accounts on the _Team_ and _Enterprise_ plans can query the dbt Cloud APIs.
 
-dbt Cloud provides two APIs:
+dbt Cloud provides the following APIs:
 
 - The [dbt Cloud Administrative API](/docs/dbt-cloud-apis/admin-cloud-api) can be used to administrate a dbt Cloud account.
 - The [dbt Cloud Discovery API](/docs/dbt-cloud-apis/discovery-api) can be used to fetch metadata related to the state and health of your dbt project.
+- The [dbt Semantic Layer API](/docs/use-dbt-semantic-layer/sl-api-overview) provides multiple API options which allow you to query your metrics defined in the dbt Semantic Layer.
 
 If you want to learn more about webhooks, refer to [Webhooks for your jobs](/docs/deploy/webhooks).
 

@@ -2,7 +2,7 @@
 title: "Enhancement: Faster run starts and unlimited job concurrency"
 description: "We have enhanced the dbt Cloud Scheduler by reducing prep time for all accounts and provided unlimited job concurrency for Enterprise accounts."
 sidebar_label: "Enhancement: Faster run starts and unlimited job concurrency"
-tags: [07-2023, scheduler]
+tags: [July-2023, scheduler]
 date: 2023-07-06
 sidebar_position: 10
 ---

diff --git a/website/docs/docs/dbt-versions/release-notes/06-July-2023/sl-revamp-beta.md b/website/docs/docs/dbt-versions/release-notes/06-July-2023/sl-revamp-beta.md
@@ -0,0 +1,51 @@
+---
+title: "Enhancement: Revamped dbt Semantic Layer available in public beta"
+description: "July 2023: The revamped dbt Semantic Layer, now available in public beta, introduces new semantic components and evolves the semantic layer's capability."
+sidebar_label: "Enhancement: Revamped dbt Semantic Layer in public beta"
+tags: [July-2023, dbt Semantic Layer]
+date: 2023-07-31
+sidebar_position: 9
+---
+
+We are thrilled to announce the re-release of the dbt Semantic Layer, now available in [public beta](#public-beta). It revolutionizes data analysis by introducing new semantic components that lay the foundation for effective organization and interaction with data. With semantics at its core, the dbt Semantic Layer marks a crucial milestone towards a new era of centralized logic and data applications.
+
+<Lightbox src="/img/sl-architecture.jpg" width="95%" title="The dbt Semantic Layer diagram displays how data flows from sources to your platform. Define and query metrics using with dbt Cloud for consistent organization-wide metrics." />
+
+## Why the dbt Semantic Layer?
+
+What sets the dbt Semantic Layer apart is its ability to centralize logic and data applications, streamlining processes and enabling efficient management and utilization of data models. It provides a consistent view of data, incorporating context and historical information, simplifying complex tasks, and reducing costs.
+
+We are excited to present several important capabilities with the enhanced dbt Semantic Layer:
+
+- **Consistent organization**: Provides a consistent view of data, ensuring that metrics and definitions match across the organization. This fosters trust in data and drives better decision-making by eliminating inconsistencies and errors that come up when individual users define metrics independently.
+
+- **Improved governance**: The dbt Semantic Layer ensures proper governance and auditing of data changes, providing an auditable record of modifications and clear ownership. This saves time by making it clear who can create and manage new metrics, ensuring accountability and data integrity.
+
+- **Reduce costs**: The dbt Semantic Layer simplifies complex tasks, such as bridging entities across a semantic graph. Often users duplicate slices and dice of data and make them available in a data platform, making it difficult to manage and causing high computation. The dbt Semantic Layer minimizes duplication of work and reducing computational costs - allowing users to focus on analyzing data rather than navigating intricate technical processes or duplicating work. 
+
+- **Enhanced efficiency**: With the dbt Semantic Layer, data teams can create and update metrics in one central location, saving time and reducing the risk of errors and downstream impacts. The agnostic approach allows seamless integration with various data platforms and downstream BI tools, making migration easier and more flexible.
+
+- **Accessible data**: Without the dbt Semantic Layer, there would be limited access to critical information which stifles effective communication. An accessible semantic layer allows all users to have equal opportunities to leverage data insights, fostering collaboration and driving innovation. 
+
+By bringing these enhancements to the dbt Semantic Layer, we enable organizations of all sizes and industries to leverage the power of semantics in their data workflows. 
+
+## Public beta 
+
+THINKING OF TURNING INTO A TABLE ONCE I HAVE THE ACCURATE INFO AND MOVING ABOVE AFTER INTO (BEFORE 'WHY SL')
+
+The dbt Semantic Layer is currently available as a public beta, which means:
+
+- **Who?** The dbt Semantic Layer is open to all dbt Cloud tiers (Developer, Team, and Enterprise) during public beta. 
+  * Developer accounts will be able to query the Proxy Server using SQL, but will not be able to browse dbt metrics in external tools, which requires access to the Semantic Layer and Discovery APIs. 
+- **What?** Public Previews provide early access to new features. The Semantic Layer is stable and you can use it for production deployments, but there may still be some planned additions and modifications to product behaviors before moving to general availability. We may also introduce new functionality that isn't backwards compatible. dbt Labs provides support, and relevant service level objectives (SLOs) apply. We will introduce pricing for the dbt Semantic Layer alongside the General Available (GA) release (future GA date to be announced).
+- **When?**  Public Preview will end once the dbt Semantic Layer is available for GA. After GA, the dbt Semantic Layer will only be available to dbt Cloud **Team** and **Enterprise** plans.
+- **Where?** Public Preview is enabled at the account level so you don’t need to worry about enabling it per user
+
+## Next steps
+
+To experience the universal dbt Semantic Layer and its enhanced beta capabilities, check out:
+
+- [Revamped dbt Semantic Layer documents](/docs/use-dbt-semantic-layer/dbt-sl)
+- [dbt Semantic Layer get started guide](/docs/use-dbt-semantic-layer/quickstart-sl)
+- [Build your metrics with MetricFlow](/docs/build/build-metrics-intro)
+- BLOG announcement link.
@@ -30,7 +30,7 @@ To create a new dbt Cloud development environment, navigate to **Deploy** -> **E
 
 ### Semantic Layer
 
-For Semantic Layer-eligible customers, the next section of environment settings is the Semantic Layer configurations. [The Semantic Layer setup guide](/docs/use-dbt-semantic-layer/setup-dbt-semantic-layer) has the most up-to-date setup instructions!
+For Semantic Layer-eligible customers, the next section of environment settings is the Semantic Layer configurations. [The Semantic Layer setup guide](/docs/use-dbt-semantic-layer/setup-sl) has the most up-to-date setup instructions!
 
 ### Deployment connection
 

@@ -1,31 +1,54 @@
 ---
 title: "Available integrations"
 id: avail-sl-integrations
-description: "Review a wide range of partners you can integrate and query with the dbt Semantic Layer."
+description: "Discover the diverse range of partners that seamlessly integrate with the powerful dbt Semantic Layer, allowing you to query and unlock valuable insights from your data ecosystem."
 sidebar_label: "Available integrations"
 ---
 
-:::info Coming soon
-The dbt Semantic Layer is undergoing a [significant revamp](https://www.getdbt.com/blog/dbt-semantic-layer-whats-next/), making it more efficient to define and query metrics.
+<VersionBlock firstVersion="1.6">
 
-**What’s changing?** The dbt_metrics package will be [deprecated](https://docs.getdbt.com/blog/deprecating-dbt-metrics) and replaced with [MetricFlow](/docs/build/about-metricflow?version=1.6), a new way framework for defining metrics in dbt.
+import NewSLChanges from '/snippets/_new-sl-changes.md';
 
-**What's new?**  Learn how to [Build your metrics](/docs/build/build-metrics-intro?version=1.6) using MetricFlow, one of the key components that makes up the revamped dbt Semantic Layer. It handles SQL query construction and defines the specification for dbt semantic models and metrics. 
-:::
+<NewSLChanges />
+
+Discover the diverse range of data applications that seamlessly integrate with the powerful dbt Semantic Layer, powered by MetricFlow &mdash; from business intelligence tools to notebooks, spreadsheets, data catalogs, and more. These integrations allow you to query and unlock valuable insights from your data ecosystem.
+
+Query dbt metrics via external integrations using the sophisticated [dbt Semantic Layer APIs](/docs/use-dbt-semantic-layer/sl-api-overview) (JDBC, GraphQL, and Discovery APIs). With these APIs, you can query metrics to avoid duplicative coding, optimize your development workflow, ensure data governance for company metrics, and guarantee consistency for data consumers.
+
+The dbt Semantic Layer integrations are capable of querying dbt metrics, importing definitions, surfacing the underlying data in partner tools, and more. Here are some of the integrations you can query from:
+
+- Tableau &mdash; 
+- Google Sheets &mdash;
+- Hex &mdash;
+- Mode &mdash; 
+
+For information on the partner integrations, their documentation, and more &mdash; refer to the [dbt Semantic Layer integrations](https://www.getdbt.com/product/semantic-layer-integrations) page.
+
+<Lightbox src="/img/docs/dbt-cloud/semantic-layer/sl_architecture.png" width="85%" title="The universal dbt Semantic Layer connecting to integration tools."/>
+
+
+## Related docs
+
+- [dbt Semantic Layer APIs](/docs/use-dbt-semantic-layer/sl-api-overview) to learn how to integrate with the JDBC, GraphQL, and Discovery APIs to query your metrics in downstream tools.
+
+</VersionBlock>
+
+<VersionBlock lastVersion="1.5">
+
+import LegacyInfo from '/snippets/_legacy-sl-callout.md';
+
+<LegacyInfo />
 
 A wide variety of data applications across the modern data stack natively integrate with the dbt Semantic Layer and dbt metrics &mdash; from Business Intelligence tools to notebooks, data catalogs, and more.
 
 The dbt Semantic Layer integrations are capable of querying dbt metrics, importing definitions, surfacing the underlying data in partner tools, and leveraging the dbt Server. 
 
 For information on the partner integrations, their documentation, and more &mdash; refer to the [dbt Semantic Layer integrations](https://www.getdbt.com/product/semantic-layer-integrations) page.
 
-<Lightbox src="/img/docs/dbt-cloud/semantic-layer/sl_architecture.png" title="dbt Semantic Layer architecture" />
-
+<Lightbox src="/img/docs/dbt-cloud/semantic-layer/sl_architecture.png" width="85%" title="The universal dbt Semantic Layer connecting to integration tools."/>
 
 ## Related docs
 
-- [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-semantic-layer) to learn more about the dbt Semantic Layer.
-- [Product architecture](/docs/use-dbt-semantic-layer/dbt-semantic-layer#product-architecture) for more information on plan availability.
-- [Public Preview information](/docs/use-dbt-semantic-layer/quickstart-semantic-layer#public-preview) to understand what Public Preview for the dbt Semantic Layer means.
-- [dbt Semantic Layer partner integration guide](/guides/dbt-ecosystem/sl-partner-integration-guide) for information about partner integration guidelines, product roadmap, and API connectivity.
-- [How to design and structure dbt metrics: Recommendations for getting started](https://docs.getdbt.com/blog/how-to-design-and-structure-metrics) to understand best practices for designing and structuring metrics in your dbt project.
+- [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) to learn more about the dbt Semantic Layer.
+
+</VersionBlock>