SubmittingPatches: replace numbered attributes with names
Use names instead of numbers for the AsciiDoc attributes that are used for the footnotes. We will add more footnotes in subsequent commits, and attributes should ideally all be unique. Having named attributes will help ensure uniqueness, and we won't have to re-number the attributes if we add a footnote earlier in the document. In addition it also clarifies that the attribute name/number is not related to the number the footnote will get in the output. Signed-off-by: Thomas Gummerer <t.gummerer@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Thomas Gummerer committed
May 30, 2018 at 21:52 UTC
a27cd1ab7f1926085521352ca79d89e00d17911b
1 file changed
+4
-4
Documentation/SubmittingPatches
+4
-4
@@ -264,12 +264,12 @@ people who are involved in the area you are touching (the output from
264
`git blame $path` and `git shortlog --no-merges $path` would help to
265
identify them), to solicit comments and reviews.
266
267
-:1: footnote:[The current maintainer: gitster@pobox.com]
268
-:2: footnote:[The mailing list: git@vger.kernel.org]
267
+:current-maintainer: footnote:[The current maintainer: gitster@pobox.com]
268
+:git-ml: footnote:[The mailing list: git@vger.kernel.org]
269
270
After the list reached a consensus that it is a good idea to apply the
271
-patch, re-send it with "To:" set to the maintainer{1} and "cc:" the
272
-list{2} for inclusion.
271
+patch, re-send it with "To:" set to the maintainer{current-maintainer} and "cc:" the
272
+list{git-ml} for inclusion.
273
274
Do not forget to add trailers such as `Acked-by:`, `Reviewed-by:` and
275
`Tested-by:` lines as necessary to credit people who helped your