commit 23c1d16ce1558a22ae0db934210eb3c0fa52e9c8
author Edwin Kempin <ekempin@google.com> Fri Jun 18 12:42:59 2021 +0200
committer Edwin Kempin <ekempin@google.com> Fri Jun 18 12:42:59 2021 +0200
tree 219df88d36daeb540b4c39814f37b5e9655d636a
parent ecfec2932d763ea91082ac726bc6a942b56f7cb2

How to use page: Rework override section

Signed-off-by: Edwin Kempin <ekempin@google.com>
Change-Id: Ie142bb88c8a9a10a2195015120d2e00f126a8fa0

resources/Documentation/how-to-use.md

diff --git a/resources/Documentation/how-to-use.md b/resources/Documentation/how-to-use.md
index 08a33a1..9a9032f 100644
--- a/resources/Documentation/how-to-use.md
+++ b/resources/Documentation/how-to-use.md
@@ -103,7 +103,7 @@
 For these cases, we advise you to:
 
 1. Ask someone with override powers (e.g. sheriff) to grant a [code owner
-   override](#codeOwnerOverride) vote to unblock the change submission.
+   override](#applyingCodeOwnerOverride) vote to unblock the change submission.
 2. Contact the project owner to ask them to fix the code owner definitions, or
    permissions if needed.
 
@@ -234,21 +234,22 @@
 - Not show the `Code-Owners` submit requirement
 - Not show the file status
 
-### Owners-Override label
+### <a id="applyingCodeOwnerOverride">Applying a code owner override
 
-#### In the reply dialog
+Users with certain permissions (e.g. sheriffs) can bypass the `Code Owners`
+submit requirement by applying a [code owner
+override](user-guide.html#codeOwnerOverride) approval (usually a
+`Owners-Override+1` vote).
 
-The `Owners-Override` label is votable by a user with certain permissions (e.g.
-sheriff). The `Owner-Override` label will show in the reply dialog and you can
-vote on it if you have certain permissions.
+The code owner override approval is applied by voting on the override label in
+the reply dialog, the same way as voting on any other label is done. Voting on
+the override label is only offered to users that have permissions to vote on
+this label.
 
 ![code owner override label in reply dialog](./code-owner-override-label-in-reply.png "Vote on owners-override label")
 
-#### In the change page
-
-When a user with certain permissions has voted "Owners-Override+1" and the
-`Code-Owners` submit requirement returns the status `Approved
-(Owners-Override)`.
+If a code owner override approval has been applied, the `Code Owners` submit
+requirement returns the status `Approved (Owners-Override)`.
 
 ![code owner override label in change page](./code-owner-override-label-in-change.png "Owners-override label")