Re: [PATCH v2 00/21] Convert hwmon documentation to ReST

From: Guenter Roeck
Date: Fri Apr 12 2019 - 23:17:56 EST


On 4/12/19 9:04 AM, Jonathan Corbet wrote:
On Thu, 11 Apr 2019 14:07:31 -0700
Guenter Roeck <linux@xxxxxxxxxxxx> wrote:

While nobody does such split, IMHO, the best would be to keep the
information outside Documentation/admin-guide. But hey! You're
the Doc maintainer. If you prefer to move, I'm perfectly fine
with that.

Same here, but please don't move the files which are kernel facing only.

Well, let's step back and think about this. Who is the audience for
these documents? That will tell us a lot about where they should really
be.

What I would prefer to avoid is the status quo where *everything* is in
the top-level directory, and where documents are organized for the
convenience of their maintainers rather than of their readers. But
sometimes I feel like I'm alone in that desire...:)


The big real-world question is: Is the series good enough for you to accept,
or do you expect some level of user/kernel separation ?

Guenter