From: Philip Oakley <philipoakley@iee.email>
Date: Sat, 15 Jan 2022 00:08:05 GMT
Subject: Re: [PATCH] README.md: add CodingGuidelines and a link for Translators
Message-ID: <6b626f9d-05d6-1903-0b38-e3566e357472@iee.email>
In-Reply-To: <xmqq7db2avij.fsf@gitster.g>

On 14/01/2022 20:54, Junio C Hamano wrote:
> "Philip Oakley via GitGitGadget" <gitgitgadget@gmail.com> 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@vger.kernel.org (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@vger.kernel.org. The mailing list archives are
>> -available at <https://lore.kernel.org/git/>,
>> +the body to majordomo@vger.kernel.org (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