2 files changed, 6 insertions, 0 deletions

diff --git a/docs/implementation-notes/python_architecture.rst b/docs/ancient_architecture_notes.rst

index 8beaa615d0..2a5a2613c4 100644
--- a/docs/implementation-notes/python_architecture.rst
+++ b/docs/ancient_architecture_notes.rst
@@ -1,3 +1,9 @@
+.. WARNING::
+  These architecture notes are spectacularly old, and date back to when Synapse 
+  was just federation code in isolation.  This should be merged into the main
+  spec.
+  
+
 = Server to Server =
 
 == Server to Server Stack ==
diff --git a/docs/implementation-notes/code_style.rst b/docs/code_style.rst

index d7e2d5e69e..d7e2d5e69e 100644
--- a/docs/implementation-notes/code_style.rst
+++ b/docs/code_style.rst