Subject: Re: [PATCH] README.md: add CodingGuidelines and a link for Translators

From: Junio C Hamano <[email-masked]>
Date: Fri, 14 Jan 2022 12:54:12 -0800

"Philip Oakley via GitGitGadget" <[email-masked]> writes:

> From: Philip Oakley <[email-masked]>
>
> Also space out the list joining instructions and clarify the subscription

the instructions to join the list?

>  requests, comments and patches to [email-masked] (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]?

> +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...

> +(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 [email-masked]. The mailing list archives are
> -available at <https://lore.kernel.org/git/>,
> +the body to [email-masked] (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