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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20230112195552.qapndatj66nqmu4n@numero-86.vaga.pv.it>
Date:   Thu, 12 Jan 2023 20:55:52 +0100
From:   Federico Vaga <federico.vaga@...a.pv.it>
To:     Jonathan Corbet <corbet@....net>
Cc:     linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH V2] doc: monospace style for inline code in botching ioctl

On Wed, Jan 11, 2023 at 03:59:57PM -0700, Jonathan Corbet wrote:
>Federico Vaga <federico.vaga@...a.pv.it> writes:
>
>> Highlighting inline code improves text readability.
>>
>> Signed-off-by: Federico Vaga <federico.vaga@...a.pv.it>
>
>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