diff --git a/specs/raw/raw.md b/docs/raw/raw.md
similarity index 100%
rename from specs/raw/raw.md
rename to docs/raw/raw.md
diff --git a/specs/raw/status-blockchain-spec.md b/docs/raw/status-blockchain-spec.md
similarity index 100%
rename from specs/raw/status-blockchain-spec.md
rename to docs/raw/status-blockchain-spec.md
diff --git a/specs/raw/status-browser-spec.md b/docs/raw/status-browser-spec.md
similarity index 100%
rename from specs/raw/status-browser-spec.md
rename to docs/raw/status-browser-spec.md
diff --git a/specs/raw/status-storage-spec.md b/docs/raw/status-storage-spec.md
similarity index 100%
rename from specs/raw/status-storage-spec.md
rename to docs/raw/status-storage-spec.md
diff --git a/specs/stable/1-client.md b/docs/stable/1-client.md
similarity index 100%
rename from specs/stable/1-client.md
rename to docs/stable/1-client.md
diff --git a/specs/stable/2-account.md b/docs/stable/2-account.md
similarity index 100%
rename from specs/stable/2-account.md
rename to docs/stable/2-account.md
diff --git a/specs/stable/3-whisper-usage.md b/docs/stable/3-whisper-usage.md
similarity index 100%
rename from specs/stable/3-whisper-usage.md
rename to docs/stable/3-whisper-usage.md
diff --git a/specs/stable/4-whisper-mailserver.md b/docs/stable/4-whisper-mailserver.md
similarity index 100%
rename from specs/stable/4-whisper-mailserver.md
rename to docs/stable/4-whisper-mailserver.md
diff --git a/specs/stable/5-secure-transport.md b/docs/stable/5-secure-transport.md
similarity index 100%
rename from specs/stable/5-secure-transport.md
rename to docs/stable/5-secure-transport.md
diff --git a/specs/stable/6-payloads.md b/docs/stable/6-payloads.md
similarity index 100%
rename from specs/stable/6-payloads.md
rename to docs/stable/6-payloads.md
diff --git a/specs/stable/7-group-chat.md b/docs/stable/7-group-chat.md
similarity index 100%
rename from specs/stable/7-group-chat.md
rename to docs/stable/7-group-chat.md
diff --git a/specs/stable/8-eips.md b/docs/stable/8-eips.md
similarity index 100%
rename from specs/stable/8-eips.md
rename to docs/stable/8-eips.md
diff --git a/specs/stable/stable.md b/docs/stable/stable.md
similarity index 93%
rename from specs/stable/stable.md
rename to docs/stable/stable.md
index 518f23a..8088b4c 100644
--- a/specs/stable/stable.md
+++ b/docs/stable/stable.md
@@ -7,3 +7,5 @@ permalink: /specs/stable
 ---
 
 # Stable specifications
+
+{.toc.}