diff --git a/docs/how-to-deploy.md b/docs/how-to-deploy.md
index b1222aac5cddc196add7ea8020f59641df3b39eb..c32d3619a6d12657843b43ee9083291faed1c4e1 100644
--- a/docs/how-to-deploy.md
+++ b/docs/how-to-deploy.md
@@ -1,3 +1,5 @@
+These docs are intendended to replace both docs.zed.dev and introduce people to how to build Zed from source.
+
 1. `cd docs` from repo root
 1. Install the vercel cli if you haven't already
     - `pnpm i -g vercel`