[PATCH 2/4] docs: Document the address/unaddressed comment feature

[Stephen Finucane]

Signed-off-by: Stephen Finucane <stephen at that.guru>
---
 docs/usage/overview.rst | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

diff --git docs/usage/overview.rst docs/usage/overview.rst
index 273c792a..a58acfa5 100644
--- docs/usage/overview.rst
+++ docs/usage/overview.rst
@@ -71,11 +71,11 @@ Cover Letters
 ~~~~~~~~~~~~~
 
 Cover letters provide a way to offer a "big picture" overview of a series of
-patches. When using Git, these mails can be recognised by way of their `0/N`
-subject prefix, e.g. `[00/11] A sample series`. Like patches, Patchwork stores
-not only the various aspects of the cover letter itself, such as the name and
-body of the cover letter, but also various metadata associated with the email
-that the cover letter was parsed from.
+patches. When using Git, these mails can be recognised by way of their ``0/N``
+subject prefix, e.g. ``[00/11] A sample series``. Like patches, Patchwork
+stores not only the various aspects of the cover letter itself, such as the
+name and body of the cover letter, but also various metadata associated with
+the email that the cover letter was parsed from.
 
 
 Comments
@@ -181,6 +181,24 @@ system to test patches. Checks have a number of fields associated with them:
    to Patchwork.
 
 
+Comment Metadata
+----------------
+
+Like patches, Patchwork allows users to store various bits of metadata against
+comments.
+
+Action required
+~~~~~~~~~~~~~~~
+
+.. versionadded:: 3.1.0
+
+Patchwork allows users to set an "action required" flag on patch and cover
+letter comments. This flag can be set by maintainers or by the users submitting
+the cover letters. Once the submitter has provided the required information,
+either the submitter or a maintainer can mark the comment as "addressed". This
+provides a more granular way of tracking work items than patch states.
+
+
 Collections
 -----------
 
-- 
2.31.1