MIME-Version: 1.0
From:   Lukas Bulwahn <lukas.bulwahn@gmail.com>
Date:   Thu, 30 Dec 2021 14:57:16 +0100
Message-ID: <CAKXUXMw-Tg7WcfVHaWZ-sK+WFnedL+S-jA_UnsdTR=HFwxAXSw@mail.gmail.com>
Subject: Removing the deprecated htmldocs for good?
To:     "open list:DOCUMENTATION" <linux-doc@vger.kernel.org>,
        Konstantin Ryabitsev <konstantin@linuxfoundation.org>,
        Jonathan Corbet <corbet@lwn.net>
Cc:     Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
        "elana.copperman@mobileye.com" <elana.copperman@mobileye.com>
Content-Type: text/plain; charset="UTF-8"
Precedence: bulk

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