doc: add note regarding commit message trailers

dario-piotrowicz · anonrig · aduh95 · marco-ippolito · commit b5144384189d · 2025-03-06T13:38:16.000+01:00
Co-authored-by: Yagiz Nizipli <yagiz@nizipli.com> Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com> PR-URL: #56736 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
diff --git a/doc/contributing/pull-requests.md b/doc/contributing/pull-requests.md
@@ -184,6 +184,11 @@ A good commit message should describe what changed and why.
    of the log. Use the `Fixes:` prefix and the full issue URL. For other
    references use `Refs:`.
 
+   `Fixes:` and `Refs:` trailers get automatically added to your commit message
+   when the Pull Request lands as long as they are included in the
+   Pull Request's description. If the Pull Request lands in several commits,
+   by default the trailers found in the description are added to each commits.
+
    Examples:
 
    * `Fixes: https://github.com/nodejs/node/issues/1337`
