diff --git a/readme.md b/readme.md
index 2ca98990e..236351dbf 100644
--- a/readme.md
+++ b/readme.md
@@ -28,12 +28,6 @@ These specs cover specific areas of the bridge that a lot of thought went into.
 
 [valset-creation-spec](/spec/valset-creation-spec.md)
 
-[Code structure](/docs/developer/code-structure.md)
-
-[Adding integration tests](/docs/developer/modifying-integration-tests.md)
-
-[Security hotspots](/docs/developer/hotspots.md)
-
 ### Design docs
 
 These are mid-level docs which go into the most detail on various topics relating to the bridge.
@@ -64,8 +58,12 @@ To contribute to Gravity, refer to these guides.
 
 [Development environment setup](/docs/developer/environment-setup.md)
 
+[Code structure](/docs/developer/code-structure.md)
+
 [Adding integration tests](/docs/developer/modifying-integration-tests.md)
 
+[Security hotspots](/docs/developer/hotspots.md)
+
 ## Status
 
 Gravity bridge is under development and will be undergoing audits soon. Instructions for deployment and use are provided in the hope that they will be useful.