[PATCH 5/5] docs: add release note for addressed/unaddressed comments

Daniel Axtens dja at axtens.net
Wed Aug 11 09:57:24 AEST 2021


Raxel Gutierrez <raxel at google.com> writes:

> Signed-off-by: Raxel Gutierrez <raxel at google.com>
> ---
>  ...essed-patch-comments-bfe71689b6f35a22.yaml | 20 +++++++++++++++++++
>  1 file changed, 20 insertions(+)
>  create mode 100644 releasenotes/notes/comment-detail-endpoint-for-addressed-unaddressed-patch-comments-bfe71689b6f35a22.yaml
>
> diff --git a/releasenotes/notes/comment-detail-endpoint-for-addressed-unaddressed-patch-comments-bfe71689b6f35a22.yaml b/releasenotes/notes/comment-detail-endpoint-for-addressed-unaddressed-patch-comments-bfe71689b6f35a22.yaml
> new file mode 100644
> index 0000000..1b11d01
> --- /dev/null
> +++ b/releasenotes/notes/comment-detail-endpoint-for-addressed-unaddressed-patch-comments-bfe71689b6f35a22.yaml
> @@ -0,0 +1,20 @@
> +---
> +prelude: >
> +    Comments on a patch now have an addressed/unaddressed state visible as a
> +    label on each comment's header. Also, the patch comment header includes a
> +    button to change the ``addressed`` state of each respective comment. Only
> +    users with edit permissions can see the button and make these changes. To
> +    make updates to the ``addressed`` field of the ``PatchComment`` model, a
> +    new REST API endpoint ``/api/patches/<patch_id>/comments/<comment_id>/`` is
> +    added to retrieve and update individual patch comments.

Looking at existing release notes, we only use 'prelude' for release
notes specifically announcing new
versions. (e.g. releasenotes/notes/prelude-3_0-5a4905b9df203595.yaml)

A couple of changes:

 - please move any content you want preserved from prelude to another
   type of note.

 - as these are user-visible, it would be good if you could explain the
   changes without referring to the model names inside of Patchwork.

> +features:
> +  - |
> +    Patch comments now have "Addressed" and "Unaddressed" labels in the patch
> +    detail page. Users that are project maintainers, patch delegates, patch
> +    submitter, or comment submitter can change the ``addressed`` state of each
> +    comment on a patch with a button next to each label.
> +api:
> +  - |
> +    The API version has been updated to v1.3.
> +  - |
> +    New REST API endpoint at ``/api/patches/<patch_id>/comments/<comment_id>/``.
> -- 
> 2.32.0.554.ge1b32706d8-goog
>
> _______________________________________________
> Patchwork mailing list
> Patchwork at lists.ozlabs.org
> https://lists.ozlabs.org/listinfo/patchwork


More information about the Patchwork mailing list