text-wrapping; source code highlighting

diff --git a/docs/notes/styleguide.rst b/docs/notes/styleguide.rst
index 33c804c..626d4a8 100644 (file)
--- a/docs/notes/styleguide.rst
+++ b/docs/notes/styleguide.rst
@@ -61,10 +61,18 @@ Sub section headings::
     Very Deep
     ~~~~~~~~~
 
+Prose
+-----
+
+Wrap text lines at 78 characters. Where necessary, lines may exceed 78
+characters, especially if wrapping would make the source text more difficult
+to read.
+
+
 Code Examples
 -------------
 
-Wrap all code examples within 70 characters to avoid horizontal scrollbars.
+Wrap all code examples at 70 characters to avoid horizontal scrollbars.
 
 Command line examples::
 
@@ -79,12 +87,16 @@ Python interpreter examples::
 
     Label the example::
 
+    .. code-block:: python
+
         >>> import this
 
 Python examples::
 
     Descriptive title::
 
+    .. code-block:: python
+
         def get_answer():
             return 42