Set expectations for the doctest docs. :)

setup.py

@@ -20,12 +20,21 @@ from setuptools import setup
 def read(*rnames):
     return open(os.path.join(os.path.dirname(__file__), *rnames)).read()
 
+doc_intro = """
+
+Below, you'll find doctest-based documentation.  It was an expoeriment
+in reusing tests as documentation.  The experiment didn't go that
+well, but there may be details below that aren't easy to find on
+buildout.org yet.
+
+doctest-based Documentation
+***************************
+
+"""
+
 long_description=(
         read('README.rst')
-        + '\n' +
-        'Detailed Documentation\n'
-        '**********************\n'
-        + '\n' +
+        + doc_intro +
         read('src', 'zc', 'buildout', 'buildout.txt')
         + '\n' +
         read('src', 'zc', 'buildout', 'repeatable.txt')