Add tutorials section to docs (#26815)

## Summary & Motivation Adds tutorials section with placeholder categories and example tutorials. ## How I Tested These Changes Local build. ## Changelog > Insert changelog entry or delete this section. Signed-off-by: nikki everett <[email protected]>
dagster-io · Jan 3, 2025 · f0cf1f1 · f0cf1f1 · github-actions · Jan 3, 2025
1 parent 4044cd6
commit f0cf1f1
Show file tree

Hide file tree

Showing 13 changed files with 84 additions and 0 deletions.
diff --git a/docs/docs-beta/docs/tutorials/category-one/first-tutorial/index.md b/docs/docs-beta/docs/tutorials/category-one/first-tutorial/index.md
@@ -0,0 +1,6 @@
+---
+title: First tutorial
+sidebar_position: 10
+---
+
+A multi-page tutorial.
diff --git a/docs/docs-beta/docs/tutorials/category-one/first-tutorial/page-one.md b/docs/docs-beta/docs/tutorials/category-one/first-tutorial/page-one.md
@@ -0,0 +1,4 @@
+---
+title: Page one
+sidebar_position: 100
+---
diff --git a/docs/docs-beta/docs/tutorials/category-one/first-tutorial/page-two.md b/docs/docs-beta/docs/tutorials/category-one/first-tutorial/page-two.md
@@ -0,0 +1,4 @@
+---
+title: Page two
+sidebar_position: 200
+---
diff --git a/docs/docs-beta/docs/tutorials/category-one/second-tutorial/index.md b/docs/docs-beta/docs/tutorials/category-one/second-tutorial/index.md
@@ -0,0 +1,6 @@
+---
+title: Second tutorial
+sidebar_position: 20
+---
+
+Another multi-page tutorial.
diff --git a/docs/docs-beta/docs/tutorials/category-one/second-tutorial/page-one.md b/docs/docs-beta/docs/tutorials/category-one/second-tutorial/page-one.md
@@ -0,0 +1,4 @@
+---
+title: Page one
+sidebar_position: 100
+---
diff --git a/docs/docs-beta/docs/tutorials/category-one/second-tutorial/page-two.md b/docs/docs-beta/docs/tutorials/category-one/second-tutorial/page-two.md
@@ -0,0 +1,4 @@
+---
+title: Page two
+sidebar_position: 200
+---
diff --git a/docs/docs-beta/docs/tutorials/category-one/third-tutorial.md b/docs/docs-beta/docs/tutorials/category-one/third-tutorial.md
@@ -0,0 +1,6 @@
+---
+title: Third tutorial
+sidebar_position: 30
+---
+
+A single page tutorial.
diff --git a/docs/docs-beta/docs/tutorials/category-two/first-tutorial/index.md b/docs/docs-beta/docs/tutorials/category-two/first-tutorial/index.md
@@ -0,0 +1,6 @@
+---
+title: First tutorial
+sidebar_position: 10
+---
+
+A multi-page tutorial.
diff --git a/docs/docs-beta/docs/tutorials/category-two/first-tutorial/page-one.md b/docs/docs-beta/docs/tutorials/category-two/first-tutorial/page-one.md
@@ -0,0 +1,4 @@
+---
+title: Page one
+sidebar_position: 100
+---
diff --git a/docs/docs-beta/docs/tutorials/category-two/first-tutorial/page-two.md b/docs/docs-beta/docs/tutorials/category-two/first-tutorial/page-two.md
@@ -0,0 +1,4 @@
+---
+title: Page two
+sidebar_position: 200
+---
diff --git a/docs/docs-beta/docs/tutorials/index.md b/docs/docs-beta/docs/tutorials/index.md
@@ -0,0 +1,5 @@
+---
+title: Dagster tutorials
+---
+
+TK
diff --git a/docs/docs-beta/docusaurus.config.ts b/docs/docs-beta/docusaurus.config.ts
@@ -82,6 +82,12 @@ const config: Config = {
           docId: 'intro',
           position: 'left',
         },
+        {
+          label: 'Tutorials',
+          type: 'doc',
+          docId: 'tutorials/index',
+          position: 'left'
+        },
         {
           label: 'Integrations',
           type: 'doc',

diff --git a/docs/docs-beta/sidebars.ts b/docs/docs-beta/sidebars.ts
@@ -114,6 +114,31 @@ const sidebars: SidebarsConfig = {
       ],
     },
   ],
+  tutorials: [
+    'tutorials/index',
+    {
+      type: 'category',
+      label: 'Category one',
+      collapsed: false,
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'tutorials/category-one'
+        }
+      ]
+    },
+    {
+      type: 'category',
+      label: 'Category two',
+      collapsed: false,
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'tutorials/category-two'
+        }
+      ]
+    }
+  ],
   integrations: [
     {
       type: 'category',