Merge 3.2
diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
index 1f5b1e3..57d9eeb 100644
--- a/Doc/documenting/markup.rst
+++ b/Doc/documenting/markup.rst
@@ -239,8 +239,8 @@
Describes an object method. The parameters should not include the ``self``
parameter. The description should include similar information to that
- described for ``function``. This method should be nested in a class
- method, like in the example above.
+ described for ``function``. This directive should be nested in a class
+ directive, like in the example above.
.. describe:: decoratormethod
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 8df7e26..c0c75f7 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -440,7 +440,7 @@
-----------------------------------
The int type implements the :class:`numbers.Integral` :term:`abstract base
-class`. In addition, it provides one more method
+class`. In addition, it provides one more method:
.. method:: int.bit_length()