add welcome preface on reorg to pages

Author: rouilj

doc/customizing.txt

@@ -15,6 +15,17 @@ Customising Roundup
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
 
+.. admonition:: Welcome
+
+  This document used to be much larger and include a lot of
+  reference material. That has been moved to the `reference document`_.
+
+  The documentation is slowly being reorganized using the `Diataxis
+  framework`_. Help with the reorganization is welcome.
+
+  .. _reference document: reference.html
+  .. _diataxis framework: https://diataxis.fr/
+
 .. contents::
    :depth: 3
    :local:

doc/reference.txt

@@ -11,31 +11,30 @@
 Roundup Reference
 =================
 
-.. This document borrows from the ZopeBook section on ZPT. The original is at:
-   http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
+.. admonition:: Welcome
 
-.. contents::
-   :depth: 2
-   :local:
+  This document used to be part of the `customization document`_.  The
+  customization document was getting large and unwieldy.  It was a
+  combination of examples and internal information that made finding
+  information difficult. We often had questions on the mailing list that
+  were well answered in the customization document, but finding the info
+  was difficult.
 
-Welcome
-=======
+  The documentation is slowly being reorganized using the `Diataxis
+  framework`_. Help with the reorganization is welcome.
 
-This document used to be part of the `customization document`_.  The
-customization document was getting large and unwieldy.  It was a
-combination of examples and internal information that made finding
-information difficult. We often had questions on the mailing list that
-were well answered in the customization document, but finding the info
-was difficult.
+  This is the document you should look at for background on a tutorial
+  or how-to guide in the customization document.
 
-The documentation is slowly being reorganized using the `Diataxis
-framework`_. Help with the reorganization is welcome.
+  .. _customization document: customizing.html
+  .. _diataxis framework: https://diataxis.fr/
 
-This is the document you should look at for background on a tutorial
-or how-to guide in the customization document.
+.. This document borrows from the ZopeBook section on ZPT. The original is at:
+   http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
 
-.. _customization document: customizing.html
-.. _diataxis framework: https://diataxis.fr/
+.. contents::
+   :depth: 2
+   :local:
 
 Trackers in a Nutshell
 ======================