linux-kernel - Removing the deprecated htmldocs for good?

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-next>] [day] [month] [year] [list]

Date:   Thu, 30 Dec 2021 14:57:16 +0100
From:   Lukas Bulwahn <lukas.bulwahn@...il.com>
To:     "open list:DOCUMENTATION" <linux-doc@...r.kernel.org>,
        Konstantin Ryabitsev <konstantin@...uxfoundation.org>,
        Jonathan Corbet <corbet@....net>
Cc:     Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
        "elana.copperman@...ileye.com" <elana.copperman@...ileye.com>
Subject: Removing the deprecated htmldocs for good?

Hi Jonathan, hi Konstantin,

While scanning through the internet for kernel documentation, I
stumbled upon the old deprecated htmldocs under
https://www.kernel.org/doc/htmldocs/. I see that on
https://www.kernel.org/doc/, we already point out that 'htmldocs -
Kernel Documentation in docbook format (deprecated).' is deprecated.
If I am not mistaken, all the content from htmldocs has now been
transformed into .rst and has potentially evolved further and hence
all relevant information should also already be available somewhere in
https://www.kernel.org/doc/html/latest/.

Is it now time to delete the content under
https://www.kernel.org/doc/htmldocs/ for good?

I doubt that htmldocs serves any good purpose as of now and I fear
that newcomers might refer to that deprecated kernel documentation
from v4.12, just because it is available and can be found with Google
before one might find its copy in
https://www.kernel.org/doc/html/latest/. Some kernel newcomer actually
already proved that point to me by example...

Best regards,

Lukas