Re: [PATCH] doc: fix AsciiDoc syntax
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Nov 20, 2026, 18:08 UTC
- Message-ID
- <xmqqh5hbqst1.fsf@gitster.g>
- In-Reply-To
- <93127462-BCFD-4086-B19D-4B640F515140@gmail.com>
Ben Knoble <ben.knoble@gmail.com> writes:
Show 8 quoted lines
>> Fixed it to use AsciiDoc: >> >> https://gitgitgadget.github.io/#...[here] > > Good catch. > > While we’re at it, « here » is generally discouraged as link text. > It’s not particularly accessible for screen-readers, for example.
I also thought that it was a funny but understandable mistake we made, given how prevalent Markdown is these days, but didn't think of the need to improve the link text.
Great suggestion.
Show 9 quoted lines
>> The differences between using `gitgitgadget/git` and `git/git` as your base can >> -be found [here](https://gitgitgadget.github.io/#should-i-use-gitgitgadget-on-gitgitgadgets-git-fork-or-on-gits-github-mirror) >> +be found https://gitgitgadget.github.io/#should-i-use-gitgitgadget-on-gitgitgadgets-git-fork-or-on-gits-github-mirror[here] > > So perhaps we could reword this to something like > > Further [differences between …] are described online. > > with the brackets marking the link text?
Sounds good.
Thanks.