docs: add Comments docs

- developer/analysis docs
- user docs
- API docs

Author: scanny

docs/_static/img/comment-parts.png

@@ -0,0 +1,27 @@
+
+.. _comments_api:
+
+Comment-related objects
+=======================
+
+.. currentmodule:: docx.comments
+
+
+|Comments| objects
+------------------
+
+.. autoclass:: Comments()
+   :members:
+   :inherited-members:
+   :exclude-members:
+       part
+
+
+|Comment| objects
+------------------
+
+.. autoclass:: Comment()
+   :members:
+   :inherited-members:
+   :exclude-members:
+       part

docs/api/comments.rst

@@ -83,8 +83,6 @@
 
 .. |CharacterStyle| replace:: :class:`.CharacterStyle`
 
-.. |Comments| replace:: :class:`.Comments`
-
 .. |Cm| replace:: :class:`.Cm`
 
 .. |ColorFormat| replace:: :class:`.ColorFormat`
@@ -93,6 +91,10 @@
 
 .. |_Columns| replace:: :class:`._Columns`
 
+.. |Comment| replace:: :class:`.Comment`
+
+.. |Comments| replace:: :class:`.Comments`
+
 .. |CoreProperties| replace:: :class:`.CoreProperties`
 
 .. |datetime| replace:: :class:`.datetime.datetime`