git-revert.txt: add discussion

The section is inspired by git-commit.txt.

Signed-off-by: Oswald Buddenhagen <oswald.buddenhagen@gmx.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Oswald Buddenhagen 2023-08-21 19:07:20 +02:00 committed by Junio C Hamano
parent 883cb1b8f8
commit c9192f9e45
1 changed files with 10 additions and 0 deletions

View File

@ -142,6 +142,16 @@ EXAMPLES
changes. The revert only modifies the working tree and the
index.

DISCUSSION
----------

While git creates a basic commit message automatically, it is
_strongly_ recommended to explain why the original commit is being
reverted.
In addition, repeatedly reverting reverts will result in increasingly
unwieldy subject lines, for example 'Reapply "Reapply "<original subject>""'.
Please consider rewording these to be shorter and more unique.

CONFIGURATION
-------------