diff --git a/docs/basics.rst b/docs/basics.rst
index b5edd32b..faf34e09 100644
--- a/docs/basics.rst
+++ b/docs/basics.rst
@@ -139,15 +139,17 @@ attached to the node unmolested (e.g. when ``foo=1`` is passed, the
resulting schema node will have an attribute named ``foo`` with the
value ``1``).
-.. note:: You may see some higher-level systems (such as Deform) pass a
- ``widget`` argument to a SchemaNode constructor. Such systems make use of
- the fact that a SchemaNode can be passed arbitrary keyword arguments for
- extension purposes. ``widget`` and other keyword arguments not enumerated
- here but which are passed during schema node construction by someone
- constructing a schema for a particular purpose are not used internally by
- Colander; they are instead only meaningful to higher-level systems which
- consume Colander schemas. Abitrary keyword arguments are allowed to a
- schema node constructor in Colander 0.9+. Prior version disallow them.
+.. note::
+
+ You may see some higher-level systems (such as Deform) pass a ``widget``
+ argument to a SchemaNode constructor. Such systems make use of the fact
+ that a SchemaNode can be passed arbitrary keyword arguments for extension
+ purposes. ``widget`` and other keyword arguments not enumerated here but
+ which are passed during schema node construction by someone constructing a
+ schema for a particular purpose are not used internally by Colander; they
+ are instead only meaningful to higher-level systems which consume Colander
+ schemas. Abitrary keyword arguments are allowed to a schema node
+ constructor in Colander 0.9+. Prior version disallow them.
The name of a schema node that is introduced as a class-level
attribute of a :class:`colander.MappingSchema`,
@@ -389,9 +391,11 @@ attribute with the value ``None``. Each exception instance will also
have an attribute named ``node``, representing the schema node to
which the exception is related.
-.. note:: Translation strings are objects which behave like Unicode objects
- but have extra metadata associated with them for use in translation
- systems. See `http://docs.repoze.org/projects/translationstring/dev/
+.. note::
+
+ Translation strings are objects which behave like Unicode objects but have
+ extra metadata associated with them for use in translation systems. See
+ `http://docs.repoze.org/projects/translationstring/dev/
`_ for
documentation about translation strings. All error messages used by
Colander internally are translation strings, which means they can be
diff --git a/docs/binding.rst b/docs/binding.rst
index 6a84c18a..4c0a2e3f 100644
--- a/docs/binding.rst
+++ b/docs/binding.rst
@@ -1,7 +1,9 @@
Schema Binding
==============
-.. note:: Schema binding is new in colander 0.8.
+.. note::
+
+ Schema binding is new in colander 0.8.
Sometimes, when you define a schema at module-scope using a ``class``
statement, you simply don't have enough information to provide
diff --git a/docs/null.rst b/docs/null.rst
index 0b493afc..5e9439e7 100644
--- a/docs/null.rst
+++ b/docs/null.rst
@@ -308,12 +308,13 @@ value colander.null value used
value_a value_b value_a used
===================== ===================== ===========================
-.. note:: ```` in the above table represents the circumstance
- in which a key present in a :class:`colander.MappingSchema` is not
- present in a mapping passed to its
- :meth:`colander.SchemaNode.deserialize` method. In reality,
- ```` means exactly the same thing as
- :attr:`colander.null`, because the :class:`colander.Mapping`
- type does the equivalent of ``mapping.get(keyname,
- colander.null)`` to find a subvalue during deserialization.
+.. note::
+
+ ```` in the above table represents the circumstance in which a
+ key present in a :class:`colander.MappingSchema` is not present in a
+ mapping passed to its :meth:`colander.SchemaNode.deserialize` method. In
+ reality, ```` means exactly the same thing as
+ :attr:`colander.null`, because the :class:`colander.Mapping` type does the
+ equivalent of ``mapping.get(keyname, colander.null)`` to find a subvalue
+ during deserialization.