Document gerrit comment deletion procedure

Change-Id: Iedc9446ea12415c8f9ba49b7f8390442045762fa
This commit is contained in:
James E. Blair 2024-02-07 10:57:23 -08:00
parent f805502cf7
commit 19fd812c7a

View File

@ -575,6 +575,35 @@ must follow that steps:
A 200 return code means the account is active, and 204 means account inactive.
Deleting Messages or Comments
-----------------------------
Review messages or comments can not be completely deleted, but they
can have their content completely replaced with text indicating that
they have been deleted. The process is described below, and the
actual deletion command requires a reason. You may want to use
something like "removed by user request" or other similar text to
indicate why the comment was deleted.
To manually delete a review comment or message:
#. Get an HTTP password for your Gerrit admin account:
.. code-block:: shell-session
$ ssh -p 29418 username.admin@review.opendev.org gerrit set-account --generate-http-password username.admin
#. Use that along with the :git_file:`tools/gerrit-delete-comment.py`
script to delete the desired message or comment. Use the script to
list the messages or comments in order to obtain their internal
IDs, then run it again to delete the specified message or comment.
#. To reduce the attack surface, clear your HTTP password:
.. code-block:: shell-session
$ ssh -p 29418 username.admin@review.opendev.org gerrit set-account --clear-http-password username.admin
Generating a Thread Dump for Debugging
--------------------------------------