diff --git a/docs/FAQ.md b/docs/FAQ.md
index ca72b151..81613051 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -91,7 +91,7 @@ Please use PostgreSQL wherever possible, especially if you are planning to run a
 ## Dendrite is using a lot of CPU
 
 Generally speaking, you should expect to see some CPU spikes, particularly if you are joining or participating in large rooms. However, constant/sustained high CPU usage is not expected - if you are experiencing that, please join `#dendrite-dev:matrix.org` and let us know what you were doing when the
-CPU usage shot up, or file a GitHub issue. If you can take a [CPU profile](PROFILING.md) then that would
+CPU usage shot up, or file a GitHub issue. If you can take a [CPU profile](development/PROFILING.md) then that would
 be a huge help too, as that will help us to understand where the CPU time is going.
 
 ## Dendrite is using a lot of RAM
@@ -99,7 +99,7 @@ be a huge help too, as that will help us to understand where the CPU time is goi
 As above with CPU usage, some memory spikes are expected if Dendrite is doing particularly heavy work
 at a given instant. However, if it is using more RAM than you expect for a long time, that's probably
 not expected. Join `#dendrite-dev:matrix.org` and let us know what you were doing when the memory usage
-ballooned, or file a GitHub issue if you can. If you can take a [memory profile](PROFILING.md) then that
+ballooned, or file a GitHub issue if you can. If you can take a [memory profile](development/PROFILING.md) then that
 would be a huge help too, as that will help us to understand where the memory usage is happening.
 
 ## Dendrite is running out of PostgreSQL database connections
diff --git a/docs/CONTRIBUTING.md b/docs/development/CONTRIBUTING.md
similarity index 97%
rename from docs/CONTRIBUTING.md
rename to docs/development/CONTRIBUTING.md
index 21b0e7ab..2aec4c36 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/development/CONTRIBUTING.md
@@ -9,7 +9,7 @@ permalink: /development/contributing
 Everyone is welcome to contribute to Dendrite! We aim to make it as easy as
 possible to get started.
 
- ## Contribution types
+## Contribution types
 
 We are a small team maintaining a large project. As a result, we cannot merge every feature, even if it
 is bug-free and useful, because we then commit to maintaining it indefinitely. We will always accept:
@@ -57,7 +57,7 @@ to do so for future contributions.
 
 ## Getting up and running
 
-See the [Installation](installation) section for information on how to build an
+See the [Installation](../installation) section for information on how to build an
 instance of Dendrite. You will likely need this in order to test your changes.
 
 ## Code style
@@ -151,7 +151,7 @@ significant amount of CPU and RAM.
 
 Once the code builds, run [Sytest](https://github.com/matrix-org/sytest)
 according to the guide in
-[docs/sytest.md](https://github.com/matrix-org/dendrite/blob/main/docs/sytest.md#using-a-sytest-docker-image)
+[docs/development/sytest.md](https://github.com/matrix-org/dendrite/blob/main/docs/development/sytest.md#using-a-sytest-docker-image)
 so you can see whether something is being broken and whether there are newly
 passing tests.
 
diff --git a/docs/PROFILING.md b/docs/development/PROFILING.md
similarity index 100%
rename from docs/PROFILING.md
rename to docs/development/PROFILING.md
diff --git a/docs/coverage.md b/docs/development/coverage.md
similarity index 100%
rename from docs/coverage.md
rename to docs/development/coverage.md
diff --git a/docs/sytest.md b/docs/development/sytest.md
similarity index 100%
rename from docs/sytest.md
rename to docs/development/sytest.md
diff --git a/docs/tracing/opentracing.md b/docs/development/tracing/opentracing.md
similarity index 100%
rename from docs/tracing/opentracing.md
rename to docs/development/tracing/opentracing.md
diff --git a/docs/tracing/setup.md b/docs/development/tracing/setup.md
similarity index 100%
rename from docs/tracing/setup.md
rename to docs/development/tracing/setup.md