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.
Most of them are for users, some of them are for driver developers. A few
are for both, though that is generally not the intention (and one may argue
that driver internal documentation should be moved into the respective
driver source).
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...:)
I am fine with separating user pointing from kernel API/driver developer
guides, and I agree that it would make a lot of sense. As I said, please
just make sure that kernel facing files don't end up in the wrong directory.
Thanks,
Guenter
