diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 6a658311f..cd8eb6b39 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -16,8 +16,8 @@ Constellation is licensed under the [AGPLv3](LICENSE). When contributing, you al
 
 We have some documentation, guidelines and conventions that you can go through to familiarize yourself with the project and get started hacking on it.
 
-* Building, testing, deploying: [local development](/.github/docs/development.md)
-* [Code conventions](/.github/docs/conventions.md#code-conventions)
-* [Process conventions](/.github/docs/conventions.md#process-conventions)
-* [Repository layout](/.github/docs/layout.md#repository-layout)
-* [Upgrading Kubernetes](/.github/docs/upgrade-kubernetes.md)
+* Building, testing, deploying: [local development](/dev-docs/workflows/build-test-run.md)
+* [Code conventions](/dev-docs/conventions.md#code-conventions)
+* [Process conventions](/dev-docs/conventions.md#process-conventions)
+* [Repository layout](/dev-docs/layout.md#repository-layout)
+* [Upgrading Kubernetes](/dev-docs/workflows/upgrade-kubernetes.md)
diff --git a/.github/docs/conventions.md b/dev-docs/conventions.md
similarity index 100%
rename from .github/docs/conventions.md
rename to dev-docs/conventions.md
diff --git a/.github/docs/longhorn.md b/dev-docs/howto/longhorn.md
similarity index 100%
rename from .github/docs/longhorn.md
rename to dev-docs/howto/longhorn.md
diff --git a/.github/docs/nfs.md b/dev-docs/howto/nfs.md
similarity index 100%
rename from .github/docs/nfs.md
rename to dev-docs/howto/nfs.md
diff --git a/.github/docs/layout.md b/dev-docs/layout.md
similarity index 100%
rename from .github/docs/layout.md
rename to dev-docs/layout.md
diff --git a/.github/docs/development.md b/dev-docs/workflows/build-test-run.md
similarity index 100%
rename from .github/docs/development.md
rename to dev-docs/workflows/build-test-run.md
diff --git a/.github/docs/README.md b/dev-docs/workflows/github-actions.md
similarity index 100%
rename from .github/docs/README.md
rename to dev-docs/workflows/github-actions.md
diff --git a/.github/docs/qemu.md b/dev-docs/workflows/qemu.md
similarity index 100%
rename from .github/docs/qemu.md
rename to dev-docs/workflows/qemu.md
diff --git a/.github/docs/release.md b/dev-docs/workflows/release.md
similarity index 100%
rename from .github/docs/release.md
rename to dev-docs/workflows/release.md
diff --git a/.github/docs/terraform.md b/dev-docs/workflows/terraform.md
similarity index 100%
rename from .github/docs/terraform.md
rename to dev-docs/workflows/terraform.md
diff --git a/.github/docs/upgrade-kubernetes.md b/dev-docs/workflows/upgrade-kubernetes.md
similarity index 100%
rename from .github/docs/upgrade-kubernetes.md
rename to dev-docs/workflows/upgrade-kubernetes.md