dagster-io · neverett · Dec 5, 2024 · Nov 19, 2024 · Nov 20, 2024 · Nov 21, 2024
@@ -3,6 +3,7 @@
 
 # Production
 /build
+!/docs/guides/build
 
 # Generated files
 .docusaurus

@@ -15,8 +15,6 @@ To install dependencies:
 yarn install
 ```
 
-**Note**: The yarn binary is checked in, so you do not need to install yarn yourself.
-
 It also uses [Vale](https://vale.sh/) to check for issues in the documentation.
 
 Install Vale with:
@@ -44,7 +42,6 @@ The docs are broken down into the following sections:
 
 - [Tutorials](./docs/tutorials/)
 - [Guides](./docs/guides/)
-- [Concepts](./docs/concepts/)
 
 `sidebar.ts` and `docusaurus.config.ts` are the main configuration files for the documentation.
 
@@ -116,7 +113,7 @@ To build the site for production:
 yarn build
 ```
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service. This also checks for any broken links in the documentation.
+This command generates static content into the `build` directory and can be served using any static contents hosting service. This also checks for any broken links in the documentation. Note that you will need to store Algolia credentials in local environment variables to build the site for production.
 
 ## Deployment
 

@@ -1,6 +1,6 @@
 ---
 sidebar_class_name: hidden
-title: API Docs
+title: API reference
 ---
 
 import DocCardList from '@theme/DocCardList';

@@ -1,7 +1,7 @@
 ---
 title: "Code location history and rollbacks"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 4
+sidebar_position: 100
 sidebar_label: "Code location history and rollbacks"
 ---
 
@@ -54,4 +54,4 @@ If you notice an issue with newly deployed code, or your code fails to deploy su
 ## Next steps
 
 - Learn more about [Code Locations](/dagster-plus/deployment/code-locations)
-- Learn how to [Alert when a code location fails to load](/dagster-plus/deployment/alerts#alerting-when-a-code-location-fails-to-load)
+- Learn how to [Alert when a code location fails to load](/dagster-plus/features/alerts#alerting-when-a-code-location-fails-to-load)
@@ -1,6 +1,7 @@
 ---
 title: "Code locations"
 displayed_sidebar: "dagsterPlus"
+sidebar_position: 50
 ---
 
 # Code locations

@@ -2,6 +2,7 @@
 title: 'Dagster+ code requirements'
 displayed_sidebar: 'dagsterPlus'
 sidebar_label: "Code requirements"
+sidebar_position: 100
 ---
 
 Your Dagster project must meet a few requirements to run in Dagster+.

@@ -1,6 +1,7 @@
 ---
 title: "Dagster+ settings"
 unlisted: true
+sidebar_position: 200
 ---
 
 # Dagster+ settings
@@ -1,8 +1,9 @@
 ---
 title: "Deployment settings"
 displayed_sidebar: "dagsterPlus"
-sidebar_label: "Settings"
+sidebar_label: "Deployment settings"
 unlisted: true
+sidebar_position: 300
 ---
 
 # Deployment settings
@@ -1,5 +1,7 @@
 ---
+title: Deployment types
 unlisted: true
+sidebar_position: 400
 ---
 
-## Placeholder
+# Deployment types
@@ -1,7 +1,7 @@
 ---
 title: "Set environment variables using agent config"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 2
+sidebar_position: 300
 sidebar_label: "Set with agent config"
 unlisted: true
 ---

@@ -1,7 +1,7 @@
 ---
 title: "Built-in environment variables"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 3
+sidebar_position: 100
 sidebar_label: "Built-in variables"
 ---
 

@@ -1,7 +1,7 @@
 ---
 title: "Setting environment variables with the Dagster+ UI"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 1
+sidebar_position: 200
 sidebar_label: "Set with Dagster+ UI"
 ---
 

@@ -2,6 +2,11 @@
 title: "Environment variables"
 displayed_sidebar: "dagsterPlus"
 unlisted: true
+sidebar_position: 40
 ---
 
 # Environment variables
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />
@@ -1,7 +1,7 @@
 ---
 title: "Amazon ECS agents (Existing VPC)"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 11
-sidebar_label: "Amazon ECS (existing)"
+sidebar_position: 110
+sidebar_label: "Amazon ECS (Existing VPC)"
 unlisted: true
 ---
@@ -1,7 +1,7 @@
 ---
 title: "Amazon ECS agents (New VPC)"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 10
-sidebar_label: "Amazon ECS (new)"
+sidebar_position: 100
+sidebar_label: "Amazon ECS (New VPC)"
 unlisted: true
 ---
@@ -1,7 +1,7 @@
 ---
 title: "Docker agents"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 20
+sidebar_position: 200
 sidebar_label: "Docker"
 unlisted: true
 ---

@@ -0,0 +1,11 @@
+---
+title: "Agents"
+displayed_sidebar: "dagsterPlus"
+sidebar_class_name: hidden
+---
+
+# Agents
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />
@@ -1,7 +1,7 @@
 ---
 title: "Running Dagster+ agents on Kubernetes"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 30
+sidebar_position: 300
 sidebar_label: "Kubernetes"
 ---
 
@@ -95,7 +95,7 @@ An exhaustive list of settings is available [here](/dagster-plus/deployment/hybr
 
 ### Configure your agents to serve branch deployments
 
-[Branch deployments](/dagster-plus/deployment/branch-deployments) are lightweight staging environments created for each code change. To configure your Dagster+ agent to manage them:
+[Branch deployments](/dagster-plus/features/branch-deployments/index.mdx) are lightweight staging environments created for each code change. To configure your Dagster+ agent to manage them:
 
 ```yaml
 # values.yaml

@@ -1,7 +1,7 @@
 ---
 title: "Running a Dagster+ agent locally"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 40
+sidebar_position: 600
 sidebar_label: "Local"
 ---
 

@@ -1,7 +1,7 @@
 ---
 title: "Using multiple agents"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 50
+sidebar_position: 400
 unlisted: true
 ---
 

@@ -1,7 +1,7 @@
 ---
 title: "Hybrid agent settings"
 displayed_sidebar: "dagsterPlus"
-sidebar_position: 60
+sidebar_position: 700
 sidebar_label: "Settings"
 unlisted: true
 ---

@@ -1,7 +1,7 @@
 ---
 title: 'Dagster+ Hybrid architecture'
 displayed_sidebar: 'dagsterPlus'
-sidebar_position: 10
+sidebar_position: 100
 ---
 
 # Dagster+ Hybrid architecture