add SL faqs (#4942)

this PR adds SL FAQs page to the SL section, as well as various other
places

Resolves #4936

---------

Co-authored-by: Leona B. Campbell <[email protected]>

website/docs/best-practices/how-we-build-our-metrics/semantic-layer-1-intro.md

@@ -32,5 +32,5 @@ If you're ready to ship your users more power with less code, let's dive in!
 :::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-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/).
+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/). Refer to [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) for more information.
 :::

website/docs/best-practices/how-we-build-our-metrics/semantic-layer-7-conclusion.md

@@ -32,4 +32,4 @@ pagination_next: null
 
 The dbt Semantic Layer is the biggest paradigm shift thus far in the young practice of analytics engineering. It's ready to provide value right away, but is most impactful if you move your project towards increasing normalization, and allow MetricFlow to do the denormalization for you with maximum dimensionality.
 
-We will be releasing more resources soon covering implementation of the Semantic Layer in dbt Cloud with various integrated BI tools. This is just the beginning, hopefully this guide has given you a path forward for building your data platform in this new era.
+We will be releasing more resources soon covering implementation of the Semantic Layer in dbt Cloud with various integrated BI tools. This is just the beginning, hopefully this guide has given you a path forward for building your data platform in this new era. Refer to [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) for more information.

website/docs/docs/build/build-metrics-intro.md

@@ -65,5 +65,4 @@ MetricFlow allows you to:
 
 - [The dbt Semantic Layer: what's next](https://www.getdbt.com/blog/dbt-semantic-layer-whats-next/) blog
 - [Get started with MetricFlow](/docs/build/sl-getting-started)
-
-
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)

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

@@ -70,19 +70,21 @@ import SlSetUp from '/snippets/_new-sl-setup.md';
 
 <ConnectQueryAPI/>
 
-## FAQs
-
-If you're encountering some issues when defining your metrics or setting up the dbt Semantic Layer, check out a list of answers to some of the questions or problems you may be experiencing.
-
-import SlFaqs from '/snippets/_sl-faqs.md';
-
-<SlFaqs/>
-
 
 ## Next steps
 
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)
 - [About MetricFlow](/docs/build/about-metricflow)
 - [Build your metrics](/docs/build/build-metrics-intro)
 - [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)
+
+<!--
+## FAQs
+
+If you're encountering some issues when defining your metrics or setting up the dbt Semantic Layer, check out a list of answers to some of the questions or problems you may be experiencing.
+import SlFaqs from '/snippets/_sl-faqs.md';
+
+<SlFaqs/>
+-->

website/docs/docs/dbt-cloud-apis/sl-api-overview.md

@@ -15,7 +15,7 @@ import DeprecationNotice from '/snippets/_sl-deprecation-notice.md';
 
 </VersionBlock>
 
-The rapid growth of different tools in the modern data stack has helped data professionals address the diverse needs of different teams. The downside of this growth is the fragmentation of business logic across teams, tools, and workloads.<br />
+The rapid growth of different tools in the modern data stack has helped data professionals address the diverse needs of different teams. The downside of this growth is the fragmentation of business logic across teams, tools, and workloads.<br /><br />
 
 The [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) allows you to define metrics in code (with [MetricFlow](/docs/build/about-metricflow)) and dynamically generate and query datasets in downstream tools based on their dbt governed assets, such as metrics and models. Integrating with the dbt Semantic Layer will help organizations that use your product make more efficient and trustworthy decisions with their data. It also helps you to avoid duplicative coding, optimize development workflow, ensure data governance, and guarantee consistency for data consumers.  
 

website/docs/docs/use-dbt-semantic-layer/avail-sl-integrations.md

@@ -39,3 +39,4 @@ import AvailIntegrations from '/snippets/_sl-partner-links.md';
 - [dbt Semantic Layer API query syntax](/docs/dbt-cloud-apis/sl-jdbc#querying-the-api-for-metric-metadata) 
 - [Hex dbt Semantic Layer cells](https://learn.hex.tech/docs/logic-cell-types/transform-cells/dbt-metrics-cells) to set up SQL cells in Hex.
 - [Resolve 'Failed APN'](/faqs/Troubleshooting/sl-alpn-error) error when connecting to the dbt Semantic Layer.
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)

website/docs/docs/use-dbt-semantic-layer/dbt-sl.md

@@ -19,9 +19,9 @@ import DeprecationNotice from '/snippets/_sl-deprecation-notice.md';
 
 The dbt Semantic Layer, powered by [MetricFlow](/docs/build/about-metricflow), simplifies the process of defining and using critical business metrics, like `revenue` in the modeling layer (your dbt project). By centralizing metric definitions, data teams can ensure consistent self-service access to these metrics in downstream data tools and applications. The dbt Semantic Layer eliminates duplicate coding by allowing data teams to define metrics on top of existing models and automatically handles data joins. 
 
-Moving metric definitions out of the BI layer and into the modeling layer allows data teams to feel confident that different business units are working from the same metric definitions, regardless of their tool of choice. If a metric definition changes in dbt, it’s refreshed everywhere it’s invoked and creates consistency across all applications. 
+Moving metric definitions out of the BI layer and into the modeling layer allows data teams to feel confident that different business units are working from the same metric definitions, regardless of their tool of choice. If a metric definition changes in dbt, it’s refreshed everywhere it’s invoked and creates consistency across all applications.
 
-Refer to the [Why we need a universal semantic layer](https://www.getdbt.com/blog/universal-semantic-layer/)  blog post to learn more.
+Refer to the [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) or [Why we need a universal semantic layer](https://www.getdbt.com/blog/universal-semantic-layer/)  blog post to learn more.
 
 ## Explore the dbt Semantic Layer
 <!-- this partial lives here: https://github.com/dbt-labs/docs.getdbt.com/website/snippets/_sl-plan-info. Use it on diff pages and to tailor the message depending which instance can access the SL and what product lifecycle we're in. -->

website/docs/docs/use-dbt-semantic-layer/exports.md

@@ -202,3 +202,6 @@ Exports provide an integration path for tools that don't natively connect with t
 
 You can use exports to create a custom integration with tools such as PowerBI, and more.
 </detailsToggle>
+
+## Related docs
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)

website/docs/docs/use-dbt-semantic-layer/quickstart-sl.md

@@ -88,17 +88,9 @@ import SlSetUp from '/snippets/_new-sl-setup.md';
 
 <ConnectQueryAPI/>
 
-
-## FAQs
-
-If you're encountering some issues when defining your metrics or setting up the dbt Semantic Layer, check out a list of answers to some of the questions or problems you may be experiencing.
-
-import SlFaqs from '/snippets/_sl-faqs.md';
-
-<SlFaqs/>
-
-
 ## Next steps
+
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)
 - [Set up dbt Semantic Layer](/docs/use-dbt-semantic-layer/setup-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)

website/docs/docs/use-dbt-semantic-layer/setup-sl.md

@@ -40,12 +40,10 @@ import SlSetUp from '/snippets/_new-sl-setup.md';
 8. You’re done 🎉! The semantic layer should is now enabled for your project. 
 -->
 
-
-
 ## Related docs
 
 - [Build your metrics](/docs/build/build-metrics-intro)
 - [Available integrations](/docs/use-dbt-semantic-layer/avail-sl-integrations)
 - [Semantic Layer APIs](/docs/dbt-cloud-apis/sl-api-overview)
-- [Migrate your legacy Semantic Layer](/guides/sl-migration)
 - [Get started with the dbt Semantic Layer](/docs/use-dbt-semantic-layer/quickstart-sl)
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)

website/docs/docs/use-dbt-semantic-layer/sl-architecture.md

@@ -2,7 +2,7 @@
 title: "dbt Semantic Layer architecture"
 id: sl-architecture
 description: "dbt Semantic Layer product architecture and related questions."
-sidebar_label: "Architecture"
+sidebar_label: "Semantic Layer architecture"
 tags: [Semantic Layer]
 pagination_next: null
 ---
@@ -46,8 +46,5 @@ The following table compares the features available in dbt Cloud and source avai
 | Connect to downstream integrations (Tableau, Hex, Mode, Google Sheets, and so on.) | ❌ | ✅ |
 | Create and run Exports to save metrics queries as tables in your data platform. | ❌ | ✅ |
 
-## FAQs
-
-import SlFaqs from '/snippets/_sl-faqs.md';
-
-<SlFaqs/>
+## Related docs
+- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)