On 14/01/2022 20:54, Junio C Hamano wrote: > "Philip Oakley via GitGitGadget" <gitgitgadget@xxxxxxxxx> writes: > >> From: Philip Oakley <philipoakley@iee.email> >> >> Also space out the list joining instructions and clarify the subscription > the instructions to join the list? Correct. > >> requests, comments and patches to git@xxxxxxxxxxxxxxx (read >> -[Documentation/SubmittingPatches][] for instructions on patch submission). >> +[Documentation/SubmittingPatches][] for instructions on patch submission >> +and [Documentation/CodingGuidelines]() ). > Remind me the significance of using [] and () after [File Reference]? The [] is the original method used by the unchanged text, while the () appears to be the method required now. > >> +Those wishing to help with error message translation (localization L10) >> +should see [po/README.md]() > Same here. > > https://docs.github.com/en/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#links > > seems to indicate () is to enclose URL the text goes to, and if > there is no URL to go to, perhaps it does the right thing, but the > current page (which has "[Documentation/SubmittingPatches][]" and > all other reference into in-tree files with that format) seems to > render correctly with links that work, so... Unfortunately it `[]` is not working for me for the new additions. GitHub magic? > >> +(a `po` file is a portable object file for the translations). >> + >> To subscribe to the list, send an email with just "subscribe git" in >> -the body to majordomo@xxxxxxxxxxxxxxx. The mailing list archives are >> -available at <https://lore.kernel.org/git/>, >> +the body to majordomo@xxxxxxxxxxxxxxx (not the list). The mailing list >> +archives are available at <https://lore.kernel.org/git/>, >> <http://marc.info/?l=git> and other archival sites. >> >> Issues which are security relevant should be disclosed privately to >> >> base-commit: 1ffcbaa1a5f10c9f706314d77f88de20a4a498c2
