git: 7b4273d423 - main - committers-guide; Explain why Fixes: includes the commit title

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Tue, 03 Jun 2025 01:07:44 UTC
The branch main has been updated by emaste:

URL: https://cgit.FreeBSD.org/doc/commit/?id=7b4273d423d76fc40f54131d946294d7d396c2be

commit 7b4273d423d76fc40f54131d946294d7d396c2be
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2025-05-29 18:49:12 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2025-06-03 01:06:44 +0000

    committers-guide; Explain why Fixes: includes the commit title
    
    (At least one of the reasons.)
    
    Reviewed by:    markj, imp
    Sponsored by:   The FreeBSD Foundation
    Differential Revision: https://reviews.freebsd.org/D50600
---
 documentation/content/en/articles/committers-guide/_index.adoc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc
index 8262534780..bd16cc3585 100644
--- a/documentation/content/en/articles/committers-guide/_index.adoc
+++ b/documentation/content/en/articles/committers-guide/_index.adoc
@@ -2617,6 +2617,7 @@ Approved by: re (username)
 
 |`Fixes:`
 |The Git short hash and the title line of a commit that is fixed by this change as returned by `git log -n 1 --pretty=format:'%h ("%s")' GIT-COMMIT-HASH`.
+We include the commit title so that the referenced commit can be located even in the case that a future VCS migration invalidates hash references.
 
 |`MFC after:`
 |To receive an e-mail reminder to MFC at a later date, specify the number of days, weeks, or months after which an MFC is planned.