diff --git a/site/content/docs/02-basics/01-component-format.md b/site/content/docs/01-getting-started/03-component-format.md
similarity index 100%
rename from site/content/docs/02-basics/01-component-format.md
rename to site/content/docs/01-getting-started/03-component-format.md
diff --git a/site/content/docs/02-basics/meta.json b/site/content/docs/02-basics/meta.json
deleted file mode 100644
index f43b744f05..0000000000
--- a/site/content/docs/02-basics/meta.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-	"title": "Basics"
-}
diff --git a/site/content/docs/03-template-syntax/01-basics.md b/site/content/docs/02-template-syntax/01-template-syntax-basics.md
similarity index 100%
rename from site/content/docs/03-template-syntax/01-basics.md
rename to site/content/docs/02-template-syntax/01-template-syntax-basics.md
diff --git a/site/content/docs/03-template-syntax/02-logic-blocks.md b/site/content/docs/02-template-syntax/02-logic-blocks.md
similarity index 100%
rename from site/content/docs/03-template-syntax/02-logic-blocks.md
rename to site/content/docs/02-template-syntax/02-logic-blocks.md
diff --git a/site/content/docs/03-template-syntax/03-special-tags.md b/site/content/docs/02-template-syntax/03-special-tags.md
similarity index 100%
rename from site/content/docs/03-template-syntax/03-special-tags.md
rename to site/content/docs/02-template-syntax/03-special-tags.md
diff --git a/site/content/docs/03-template-syntax/04-element-directives.md b/site/content/docs/02-template-syntax/04-element-directives.md
similarity index 100%
rename from site/content/docs/03-template-syntax/04-element-directives.md
rename to site/content/docs/02-template-syntax/04-element-directives.md
diff --git a/site/content/docs/03-template-syntax/05-component-directives.md b/site/content/docs/02-template-syntax/05-component-directives.md
similarity index 100%
rename from site/content/docs/03-template-syntax/05-component-directives.md
rename to site/content/docs/02-template-syntax/05-component-directives.md
diff --git a/site/content/docs/03-template-syntax/06-special-elements.md b/site/content/docs/02-template-syntax/06-special-elements.md
similarity index 100%
rename from site/content/docs/03-template-syntax/06-special-elements.md
rename to site/content/docs/02-template-syntax/06-special-elements.md
diff --git a/site/content/docs/03-template-syntax/meta.json b/site/content/docs/02-template-syntax/meta.json
similarity index 100%
rename from site/content/docs/03-template-syntax/meta.json
rename to site/content/docs/02-template-syntax/meta.json
diff --git a/site/content/docs/04-runtime/01-svelte.md b/site/content/docs/03-runtime/01-svelte.md
similarity index 100%
rename from site/content/docs/04-runtime/01-svelte.md
rename to site/content/docs/03-runtime/01-svelte.md
diff --git a/site/content/docs/04-runtime/02-svelte-store.md b/site/content/docs/03-runtime/02-svelte-store.md
similarity index 100%
rename from site/content/docs/04-runtime/02-svelte-store.md
rename to site/content/docs/03-runtime/02-svelte-store.md
diff --git a/site/content/docs/04-runtime/03-svelte-motion.md b/site/content/docs/03-runtime/03-svelte-motion.md
similarity index 100%
rename from site/content/docs/04-runtime/03-svelte-motion.md
rename to site/content/docs/03-runtime/03-svelte-motion.md
diff --git a/site/content/docs/04-runtime/04-svelte-transition.md b/site/content/docs/03-runtime/04-svelte-transition.md
similarity index 100%
rename from site/content/docs/04-runtime/04-svelte-transition.md
rename to site/content/docs/03-runtime/04-svelte-transition.md
diff --git a/site/content/docs/04-runtime/05-svelte-animate.md b/site/content/docs/03-runtime/05-svelte-animate.md
similarity index 100%
rename from site/content/docs/04-runtime/05-svelte-animate.md
rename to site/content/docs/03-runtime/05-svelte-animate.md
diff --git a/site/content/docs/04-runtime/06-svelte-easing.md b/site/content/docs/03-runtime/06-svelte-easing.md
similarity index 100%
rename from site/content/docs/04-runtime/06-svelte-easing.md
rename to site/content/docs/03-runtime/06-svelte-easing.md
diff --git a/site/content/docs/02-basics/02-actions.md b/site/content/docs/03-runtime/07-actions.md
similarity index 100%
rename from site/content/docs/02-basics/02-actions.md
rename to site/content/docs/03-runtime/07-actions.md
diff --git a/site/content/docs/04-runtime/meta.json b/site/content/docs/03-runtime/meta.json
similarity index 100%
rename from site/content/docs/04-runtime/meta.json
rename to site/content/docs/03-runtime/meta.json
diff --git a/site/content/docs/05-compiler-and-api/01-svelte-compiler.md b/site/content/docs/04-compiler-and-api/01-svelte-compiler.md
similarity index 100%
rename from site/content/docs/05-compiler-and-api/01-svelte-compiler.md
rename to site/content/docs/04-compiler-and-api/01-svelte-compiler.md
diff --git a/site/content/docs/05-compiler-and-api/02-client-side-component-api.md b/site/content/docs/04-compiler-and-api/02-client-side-component-api.md
similarity index 100%
rename from site/content/docs/05-compiler-and-api/02-client-side-component-api.md
rename to site/content/docs/04-compiler-and-api/02-client-side-component-api.md
diff --git a/site/content/docs/05-compiler-and-api/03-server-side-component-api.md b/site/content/docs/04-compiler-and-api/03-server-side-component-api.md
similarity index 100%
rename from site/content/docs/05-compiler-and-api/03-server-side-component-api.md
rename to site/content/docs/04-compiler-and-api/03-server-side-component-api.md
diff --git a/site/content/docs/05-compiler-and-api/04-custom-elements-api.md b/site/content/docs/04-compiler-and-api/04-custom-elements-api.md
similarity index 100%
rename from site/content/docs/05-compiler-and-api/04-custom-elements-api.md
rename to site/content/docs/04-compiler-and-api/04-custom-elements-api.md
diff --git a/site/content/docs/05-compiler-and-api/meta.json b/site/content/docs/04-compiler-and-api/meta.json
similarity index 100%
rename from site/content/docs/05-compiler-and-api/meta.json
rename to site/content/docs/04-compiler-and-api/meta.json
diff --git a/site/content/docs/06-misc/01-accessibility-warnings.md b/site/content/docs/05-misc/01-accessibility-warnings.md
similarity index 100%
rename from site/content/docs/06-misc/01-accessibility-warnings.md
rename to site/content/docs/05-misc/01-accessibility-warnings.md
diff --git a/site/content/docs/06-misc/02-typescript.md b/site/content/docs/05-misc/02-typescript.md
similarity index 100%
rename from site/content/docs/06-misc/02-typescript.md
rename to site/content/docs/05-misc/02-typescript.md
diff --git a/site/content/docs/01-getting-started/03-migrating-v3-to-v4.md b/site/content/docs/05-misc/03-migrating-v3-to-v4.md
similarity index 100%
rename from site/content/docs/01-getting-started/03-migrating-v3-to-v4.md
rename to site/content/docs/05-misc/03-migrating-v3-to-v4.md
diff --git a/site/content/docs/06-misc/meta.json b/site/content/docs/05-misc/meta.json
similarity index 100%
rename from site/content/docs/06-misc/meta.json
rename to site/content/docs/05-misc/meta.json
diff --git a/site/content/docs/07-legacy/01-svelte-register.md b/site/content/docs/06-legacy/01-svelte-register.md
similarity index 100%
rename from site/content/docs/07-legacy/01-svelte-register.md
rename to site/content/docs/06-legacy/01-svelte-register.md
diff --git a/site/content/docs/07-legacy/meta.json b/site/content/docs/06-legacy/meta.json
similarity index 100%
rename from site/content/docs/07-legacy/meta.json
rename to site/content/docs/06-legacy/meta.json