diff --git a/Documentation/images/user-review-ui-change-screen-patch-set-list.png b/Documentation/images/user-review-ui-change-screen-patch-set-list.png new file mode 100644 index 0000000000..702bf4f44e Binary files /dev/null and b/Documentation/images/user-review-ui-change-screen-patch-set-list.png differ diff --git a/Documentation/images/user-review-ui-change-screen-patch-sets.png b/Documentation/images/user-review-ui-change-screen-patch-sets.png new file mode 100644 index 0000000000..45b4089e02 Binary files /dev/null and b/Documentation/images/user-review-ui-change-screen-patch-sets.png differ diff --git a/Documentation/user-review-ui.txt b/Documentation/user-review-ui.txt index 6b78b9810a..abb108fdd2 100644 --- a/Documentation/user-review-ui.txt +++ b/Documentation/user-review-ui.txt @@ -49,6 +49,7 @@ required to make the change submittable. The change is in review and a veto vote on the shown label is preventing the submit. +[[not-current]] - `Not Current`: + The currently viewed patch set is outdated. @@ -373,6 +374,32 @@ diff views for all files in the file list. image::images/user-review-ui-change-screen-file-list-header.png[width=800, link="images/user-review-ui-change-screen-file-list-header.png"] +[[patch-sets]] +=== Patch Sets + +The change screen only presents one patch set at a time. Which patch +set is currently viewed can be seen from the `Patch Sets` drop-down +panel in the change header. It shows the number of the currently viewed +patch set and the total number of patch sets, in the form: "current +patch set/number of patch sets". + +If a non-current patch set is viewed this is indicated by the +link:#not-current[Not Current] change state. Please note that some +operations are only available on the current patch set. + +image::images/user-review-ui-change-screen-patch-sets.png[width=800, link="images/user-review-ui-change-screen-patch-sets.png"] + +The patch set drop-down list shows the list of patch sets and allows to +switch between them. The patch sets are sorted in descending order so +that the current patch set is always on top. + +Patch sets that have unpublished draft comments are marked by a comment +icon. + +Draft patch sets are marked with `DRAFT`. + +image::images/user-review-ui-change-screen-patch-set-list.png[width=800, link="images/user-review-ui-change-screen-patch-set-list.png"] + [[old-change-screen]] === Old Change Screen