]> git.ipfire.org Git - thirdparty/git.git/commitdiff
SubmittingPatches: discourage new trailers
authorJosh Soref <jsoref@gmail.com>
Thu, 28 Dec 2023 04:55:19 +0000 (04:55 +0000)
committerJunio C Hamano <gitster@pobox.com>
Thu, 28 Dec 2023 05:33:23 +0000 (21:33 -0800)
There seems to be consensus amongst the core Git community on a working
set of common trailers, and there are non-trivial costs to people
inventing new trailers (research to discover what they mean/how they
differ from existing trailers) such that inventing new ones is generally
unwarranted and not something to be recommended to new contributors.

Suggested-by: Elijah Newren <newren@gmail.com>
Signed-off-by: Josh Soref <jsoref@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/SubmittingPatches

index 32e9023877747bedf56037db71620d41bef17fd6..58dfe4050496afa6e186784f48c77429ee0dd837 100644 (file)
@@ -356,8 +356,9 @@ If you like, you can put extra tags at the end:
 . `Tested-by:` is used to indicate that the person applied the patch
   and found it to have the desired effect.
 
-You can also create your own tag or use one that's in common usage
-such as "Thanks-to:", "Based-on-patch-by:", or "Mentored-by:".
+While you can also create your own trailer if the situation warrants it, we
+encourage you to instead use one of the common trailers in this project
+highlighted above.
 
 [[git-tools]]
 === Generate your patch using Git tools out of your commits.