Re: [RFC PATCH 0/2] Rework the kernel's README.rst

From: Jonathan Corbet
Date: Thu Jul 28 2022 - 11:56:51 EST


Lukas Bulwahn <lukas.bulwahn@xxxxxxxxx> writes:

> As far as I see, the README.rst file in Documentation/admin-guide/ covers
> three rather outdated (or subsumed) aspects:
>
> 1. mentioning that it is possible to "run a.out user programs with this kernel"
>
> 2. how to report a kernel bug
>
> 3. the explanations around the use of LILO as a boot loader
>
> This patch series addressed the first two aspects; the third one simply
> first needs some more experimenting/experience on my side to update
> the description of the setup with a GRUB boot loader.
>
> I am happy if anyone else contributes or helps with this rework task on
> the third aspect.
>
> I am also adding Linus as recipient, as he seems to be the original author,
> i.e., in the text, 'me' refers to Linus.
>
> Please let me know if you are generally fine with this approach, and
> if there is something on the other documentation to be done to get this
> patch accepted.

The changes seem fine to me; I'll apply them after the merge window if
nobody objects.

Longer term it's probably worth thinking about what the README.rst file
is for. It seems like we should have one starting point for somebody's
first encounter with the docs; that would likely either be this file or
Documentation/index.rst but not both. I keep meaning to try to improve
the initial documentation experience, but haven't found the time yet...

Thanks,

jon