From 7fc3cbff8c6f3ea79a3117da97a6116f1cd26148 Mon Sep 17 00:00:00 2001
From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com>
Date: Thu, 30 Nov 2023 10:48:59 -0800
Subject: [PATCH] Adding landing pages for autogenerated FAQ directories
 (#4560)

Closes https://github.com/dbt-labs/docs.getdbt.com/issues/2748

## What are you changing in this pull request and why?

Adding a page that will hopefully add a landing page. This will ensure
breadcrumbs work which helps with SEO and will help @kbrock91 be able to
link to a section in the FAQs when necessary.

## Checklist
<!--
Uncomment if you're publishing docs for a prerelease version of dbt
(delete if not applicable):
- [ ] Add versioning components, as described in [Versioning
Docs](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-entire-pages)
- [ ] Add a note to the prerelease version [Migration
Guide](https://github.com/dbt-labs/docs.getdbt.com/tree/current/website/docs/docs/dbt-versions/core-upgrade)
-->
- [ ] Review the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md)
so my content adheres to these guidelines.
- [ ] For [docs
versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning),
review how to [version a whole
page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version)
and [version a block of
content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content).
- [ ] Add a checklist item for anything that needs to happen before this
PR is merged, such as "needs technical review" or "change base branch."

Adding new pages (delete if not applicable):
- [ ] Add page to `website/sidebars.js`
- [ ] Provide a unique filename for the new page

Removing or renaming existing pages (delete if not applicable):
- [ ] Remove page from `website/sidebars.js`
- [ ] Add an entry `website/static/_redirects`
- [ ] Run link testing locally with `npm run build` to update the links
that point to the deleted page

---------

Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com>
---
 website/docs/faqs/API/_category_.yaml             | 10 ++++++++++
 website/docs/faqs/Accounts/_category_.yaml        | 10 ++++++++++
 website/docs/faqs/Core/_category_.yaml            | 10 ++++++++++
 website/docs/faqs/Docs/_category_.yaml            | 10 ++++++++++
 website/docs/faqs/Environments/_category_.yaml    | 10 ++++++++++
 website/docs/faqs/Git/_category_.yaml             | 10 ++++++++++
 website/docs/faqs/Jinja/_category_.yaml           | 10 ++++++++++
 website/docs/faqs/Models/_category_.yaml          | 10 ++++++++++
 website/docs/faqs/Project/_category_.yaml         | 10 ++++++++++
 website/docs/faqs/Runs/_category_.yaml            | 10 ++++++++++
 website/docs/faqs/Seeds/_category_.yaml           | 10 ++++++++++
 website/docs/faqs/Snapshots/_category_.yaml       | 10 ++++++++++
 website/docs/faqs/Tests/_category_.yaml           | 10 ++++++++++
 website/docs/faqs/Troubleshooting/_category_.yaml | 10 ++++++++++
 website/docs/faqs/Warehouse/_category_.yaml       | 10 ++++++++++
 15 files changed, 150 insertions(+)
 create mode 100644 website/docs/faqs/API/_category_.yaml
 create mode 100644 website/docs/faqs/Accounts/_category_.yaml
 create mode 100644 website/docs/faqs/Core/_category_.yaml
 create mode 100644 website/docs/faqs/Docs/_category_.yaml
 create mode 100644 website/docs/faqs/Environments/_category_.yaml
 create mode 100644 website/docs/faqs/Git/_category_.yaml
 create mode 100644 website/docs/faqs/Jinja/_category_.yaml
 create mode 100644 website/docs/faqs/Models/_category_.yaml
 create mode 100644 website/docs/faqs/Project/_category_.yaml
 create mode 100644 website/docs/faqs/Runs/_category_.yaml
 create mode 100644 website/docs/faqs/Seeds/_category_.yaml
 create mode 100644 website/docs/faqs/Snapshots/_category_.yaml
 create mode 100644 website/docs/faqs/Tests/_category_.yaml
 create mode 100644 website/docs/faqs/Troubleshooting/_category_.yaml
 create mode 100644 website/docs/faqs/Warehouse/_category_.yaml

diff --git a/website/docs/faqs/API/_category_.yaml b/website/docs/faqs/API/_category_.yaml
new file mode 100644
index 00000000000..fac67328a7a
--- /dev/null
+++ b/website/docs/faqs/API/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'API'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: API FAQs
+customProps:
+  description: Frequently asked questions about dbt APIs
diff --git a/website/docs/faqs/Accounts/_category_.yaml b/website/docs/faqs/Accounts/_category_.yaml
new file mode 100644
index 00000000000..b8ebee5fe2a
--- /dev/null
+++ b/website/docs/faqs/Accounts/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Accounts'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Account FAQs
+customProps:
+  description: Frequently asked questions about your account in dbt
diff --git a/website/docs/faqs/Core/_category_.yaml b/website/docs/faqs/Core/_category_.yaml
new file mode 100644
index 00000000000..bac4ad4a655
--- /dev/null
+++ b/website/docs/faqs/Core/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'dbt Core'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: 'dbt Core FAQs'
+customProps:
+  description: Frequently asked questions about dbt Core
diff --git a/website/docs/faqs/Docs/_category_.yaml b/website/docs/faqs/Docs/_category_.yaml
new file mode 100644
index 00000000000..8c7925dcc15
--- /dev/null
+++ b/website/docs/faqs/Docs/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'dbt Docs'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: dbt Docs FAQs
+customProps:
+  description: Frequently asked questions about dbt Docs
diff --git a/website/docs/faqs/Environments/_category_.yaml b/website/docs/faqs/Environments/_category_.yaml
new file mode 100644
index 00000000000..8d252d2c5d3
--- /dev/null
+++ b/website/docs/faqs/Environments/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Environments'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: 'Environments FAQs'
+customProps:
+  description: Frequently asked questions about Environments in dbt
diff --git a/website/docs/faqs/Git/_category_.yaml b/website/docs/faqs/Git/_category_.yaml
new file mode 100644
index 00000000000..0d9e5ee6e91
--- /dev/null
+++ b/website/docs/faqs/Git/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Git'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Git FAQs
+customProps:
+  description: Frequently asked questions about Git and dbt
diff --git a/website/docs/faqs/Jinja/_category_.yaml b/website/docs/faqs/Jinja/_category_.yaml
new file mode 100644
index 00000000000..809ca0bb8eb
--- /dev/null
+++ b/website/docs/faqs/Jinja/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Jinja'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Jinja FAQs
+customProps:
+  description: Frequently asked questions about Jinja and dbt
diff --git a/website/docs/faqs/Models/_category_.yaml b/website/docs/faqs/Models/_category_.yaml
new file mode 100644
index 00000000000..7398058db2b
--- /dev/null
+++ b/website/docs/faqs/Models/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Models'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Models FAQs
+customProps:
+  description: Frequently asked questions about Models in dbt
diff --git a/website/docs/faqs/Project/_category_.yaml b/website/docs/faqs/Project/_category_.yaml
new file mode 100644
index 00000000000..d2f695773f8
--- /dev/null
+++ b/website/docs/faqs/Project/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Projects'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Project FAQs
+customProps:
+  description: Frequently asked questions about projects in dbt
diff --git a/website/docs/faqs/Runs/_category_.yaml b/website/docs/faqs/Runs/_category_.yaml
new file mode 100644
index 00000000000..5867a0d3710
--- /dev/null
+++ b/website/docs/faqs/Runs/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Runs'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Runs FAQs
+customProps:
+  description: Frequently asked questions about runs in dbt
diff --git a/website/docs/faqs/Seeds/_category_.yaml b/website/docs/faqs/Seeds/_category_.yaml
new file mode 100644
index 00000000000..fd2f7d3d925
--- /dev/null
+++ b/website/docs/faqs/Seeds/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Seeds'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Seeds FAQs
+customProps:
+  description: Frequently asked questions about seeds in dbt
diff --git a/website/docs/faqs/Snapshots/_category_.yaml b/website/docs/faqs/Snapshots/_category_.yaml
new file mode 100644
index 00000000000..743b508fefe
--- /dev/null
+++ b/website/docs/faqs/Snapshots/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Snapshots'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Snapshots FAQs
+customProps:
+  description: Frequently asked questions about snapshots in dbt
diff --git a/website/docs/faqs/Tests/_category_.yaml b/website/docs/faqs/Tests/_category_.yaml
new file mode 100644
index 00000000000..754b8ec267b
--- /dev/null
+++ b/website/docs/faqs/Tests/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Tests'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Tests FAQs
+customProps:
+  description: Frequently asked questions about tests in dbt
diff --git a/website/docs/faqs/Troubleshooting/_category_.yaml b/website/docs/faqs/Troubleshooting/_category_.yaml
new file mode 100644
index 00000000000..14c4b49044d
--- /dev/null
+++ b/website/docs/faqs/Troubleshooting/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Troubleshooting'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Troubleshooting FAQs
+customProps:
+  description: Frequently asked questions about troubleshooting dbt
diff --git a/website/docs/faqs/Warehouse/_category_.yaml b/website/docs/faqs/Warehouse/_category_.yaml
new file mode 100644
index 00000000000..4de6e2e7d5e
--- /dev/null
+++ b/website/docs/faqs/Warehouse/_category_.yaml
@@ -0,0 +1,10 @@
+# position: 2.5 # float position is supported
+label: 'Warehouse'
+collapsible: true # make the category collapsible
+collapsed: true # keep the category collapsed by default
+className: red
+link:
+  type: generated-index
+  title: Warehouse FAQs
+customProps:
+  description: Frequently asked questions about warehouses and dbt