diff --git a/docs/docs/guides/run-flow.mdx b/docs/docs/guides/run-flow.mdx
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs/docs/guides/superuser.mdx b/docs/docs/guides/superuser.mdx
deleted file mode 100644
index 04e0f96af..000000000
--- a/docs/docs/guides/superuser.mdx
+++ /dev/null
@@ -1,7 +0,0 @@
-import ThemedImage from "@theme/ThemedImage";
-import useBaseUrl from "@docusaurus/useBaseUrl";
-import ZoomableImage from "/src/theme/ZoomableImage.js";
-import ReactPlayer from "react-player";
-
-Now, we need to explain what are the permissions the superuser gets. Once logged in, they can activate new users,
-edit them,
diff --git a/docs/docs/guides/compatibility.mdx b/docs/docs/migration/compatibility.mdx
similarity index 100%
rename from docs/docs/guides/compatibility.mdx
rename to docs/docs/migration/compatibility.mdx
diff --git a/docs/docs/guides/component-status-and-data-passing.mdx b/docs/docs/migration/component-status-and-data-passing.mdx
similarity index 100%
rename from docs/docs/guides/component-status-and-data-passing.mdx
rename to docs/docs/migration/component-status-and-data-passing.mdx
diff --git a/docs/docs/guides/connecting-output-components.mdx b/docs/docs/migration/connecting-output-components.mdx
similarity index 100%
rename from docs/docs/guides/connecting-output-components.mdx
rename to docs/docs/migration/connecting-output-components.mdx
diff --git a/docs/docs/guides/experimental-components.mdx b/docs/docs/migration/experimental-components.mdx
similarity index 100%
rename from docs/docs/guides/experimental-components.mdx
rename to docs/docs/migration/experimental-components.mdx
diff --git a/docs/docs/guides/flow-of-data.mdx b/docs/docs/migration/flow-of-data.mdx
similarity index 100%
rename from docs/docs/guides/flow-of-data.mdx
rename to docs/docs/migration/flow-of-data.mdx
diff --git a/docs/docs/guides/global-variables.mdx b/docs/docs/migration/global-variables.mdx
similarity index 100%
rename from docs/docs/guides/global-variables.mdx
rename to docs/docs/migration/global-variables.mdx
diff --git a/docs/docs/guides/inputs-and-outputs.mdx b/docs/docs/migration/inputs-and-outputs.mdx
similarity index 100%
rename from docs/docs/guides/inputs-and-outputs.mdx
rename to docs/docs/migration/inputs-and-outputs.mdx
diff --git a/docs/docs/guides/multiple-flows.mdx b/docs/docs/migration/multiple-flows.mdx
similarity index 100%
rename from docs/docs/guides/multiple-flows.mdx
rename to docs/docs/migration/multiple-flows.mdx
diff --git a/docs/docs/guides/new-categories-and-components.mdx b/docs/docs/migration/new-categories-and-components.mdx
similarity index 100%
rename from docs/docs/guides/new-categories-and-components.mdx
rename to docs/docs/migration/new-categories-and-components.mdx
diff --git a/docs/docs/guides/passing-tweaks-and-inputs.mdx b/docs/docs/migration/passing-tweaks-and-inputs.mdx
similarity index 100%
rename from docs/docs/guides/passing-tweaks-and-inputs.mdx
rename to docs/docs/migration/passing-tweaks-and-inputs.mdx
diff --git a/docs/docs/guides/renaming-and-editing-components.mdx b/docs/docs/migration/renaming-and-editing-components.mdx
similarity index 100%
rename from docs/docs/guides/renaming-and-editing-components.mdx
rename to docs/docs/migration/renaming-and-editing-components.mdx
diff --git a/docs/docs/guides/sidebar-and-interaction-panel.mdx b/docs/docs/migration/sidebar-and-interaction-panel.mdx
similarity index 100%
rename from docs/docs/guides/sidebar-and-interaction-panel.mdx
rename to docs/docs/migration/sidebar-and-interaction-panel.mdx
diff --git a/docs/docs/guides/state-management.mdx b/docs/docs/migration/state-management.mdx
similarity index 100%
rename from docs/docs/guides/state-management.mdx
rename to docs/docs/migration/state-management.mdx
diff --git a/docs/docs/guides/supported-frameworks.mdx b/docs/docs/migration/supported-frameworks.mdx
similarity index 100%
rename from docs/docs/guides/supported-frameworks.mdx
rename to docs/docs/migration/supported-frameworks.mdx
diff --git a/docs/docs/guides/text-and-record.mdx b/docs/docs/migration/text-and-record.mdx
similarity index 100%
rename from docs/docs/guides/text-and-record.mdx
rename to docs/docs/migration/text-and-record.mdx