From 91ef85df33baaaa83d8dff1cdf86ee5a4e8a4bd9 Mon Sep 17 00:00:00 2001
From: Gareth Rees <gdr@ravenbrook.com>
Date: Thu, 25 Apr 2013 20:27:19 +0100
Subject: [PATCH] Add warning about the nature and correctness of the design
 documentation.

Copied from Perforce
 Change: 181454
 ServerID: perforce.ravenbrook.com
---
 mps/manual/source/design/index.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/mps/manual/source/design/index.rst b/mps/manual/source/design/index.rst
index 6a7dd9c23f7..92e59523eeb 100644
--- a/mps/manual/source/design/index.rst
+++ b/mps/manual/source/design/index.rst
@@ -3,6 +3,15 @@
 Design
 ******
 
+.. warning::
+
+    Much of the documentation in this section is very old: some of it
+    dates back to the origin of the MPS in 1995. It has not been
+    brought up to date or checked for correctness, so it is mainly of
+    historical interest. As pieces of documentation are brought up to
+    date, they will be moved to the :ref:`internals` section.
+
+
 .. toctree::
     :numbered: