Re: [PATCH V2] doc: monospace style for inline code in botching ioctl

From: Federico Vaga
Date: Thu Jan 12 2023 - 14:56:50 EST


On Wed, Jan 11, 2023 at 03:59:57PM -0700, Jonathan Corbet wrote:
Federico Vaga <federico.vaga@xxxxxxxxxx> writes:

Highlighting inline code improves text readability.

Signed-off-by: Federico Vaga <federico.vaga@xxxxxxxxxx>

It improves *HTML* text readability; the results for plain text are
... less clear. I think it's better to avoid this kind of extra markup
when we can.

Shouldn't we consider higher priority the HTML text? Perhaps I've a biased
opinion. Do you think that plain-text is the favorite way of reading the kernel
documentation?

Let me profit from this point and ask. Are there statistics about the usage of
https://www.kernel.org/doc/html/latest/?


Thanks,

jon

--
Federico Vaga