diff --git a/docs/how-to-deploy.md b/docs/how-to-deploy.md
new file mode 100644
index 0000000000..b1222aac5c
--- /dev/null
+++ b/docs/how-to-deploy.md
@@ -0,0 +1,8 @@
+1. `cd docs` from repo root
+1. Install the vercel cli if you haven't already
+    - `pnpm i -g vercel`
+1. `vercel` to deploy if you already have the project linked
+1. Otherwise, `vercel login` and `vercel` to link
+    - Choose Zed Industries as the team, then `zed-app-docs` as the project
+
+Someone can write a script for this when they have time.
diff --git a/docs_old/backend-development.md b/docs/old/backend-development.md
similarity index 100%
rename from docs_old/backend-development.md
rename to docs/old/backend-development.md
diff --git a/docs_old/building-zed.md b/docs/old/building-zed.md
similarity index 100%
rename from docs_old/building-zed.md
rename to docs/old/building-zed.md
diff --git a/docs_old/company-and-vision.md b/docs/old/company-and-vision.md
similarity index 100%
rename from docs_old/company-and-vision.md
rename to docs/old/company-and-vision.md
diff --git a/docs_old/design-tools.md b/docs/old/design-tools.md
similarity index 100%
rename from docs_old/design-tools.md
rename to docs/old/design-tools.md
diff --git a/docs_old/index.md b/docs/old/index.md
similarity index 100%
rename from docs_old/index.md
rename to docs/old/index.md
diff --git a/docs_old/local-collaboration.md b/docs/old/local-collaboration.md
similarity index 100%
rename from docs_old/local-collaboration.md
rename to docs/old/local-collaboration.md
diff --git a/docs_old/release-process.md b/docs/old/release-process.md
similarity index 100%
rename from docs_old/release-process.md
rename to docs/old/release-process.md
diff --git a/docs_old/theme/generating-theme-types.md b/docs/old/theme/generating-theme-types.md
similarity index 100%
rename from docs_old/theme/generating-theme-types.md
rename to docs/old/theme/generating-theme-types.md
diff --git a/docs_old/tools.md b/docs/old/tools.md
similarity index 100%
rename from docs_old/tools.md
rename to docs/old/tools.md
diff --git a/docs_old/zed/syntax-highlighting.md b/docs/old/zed/syntax-highlighting.md
similarity index 100%
rename from docs_old/zed/syntax-highlighting.md
rename to docs/old/zed/syntax-highlighting.md