Re: [PATCH] Documentation: filesystems: better locations for sysfs-pci, sysfs-tagging

From: John Hubbard
Date: Thu Oct 08 2020 - 15:32:41 EST


On 10/8/20 9:04 AM, Jonathan Corbet wrote:
On Wed, 7 Oct 2020 16:31:51 -0700
John Hubbard <jhubbard@xxxxxxxxxx> wrote:

sysfs-pci and sysfs-tagging were mis-filed: their locations with
Documentation/ implied that they were related to file systems. Actually,
each topic is about a very specific *use* of sysfs, and sysfs *happens*
to be a (virtual) filesystem, so this is not really the right place.

It's jarring to be reading about filesystems in general and then come
across these specific details about PCI, and tagging...and then back to
general filesystems again.

Move sysfs-pci and sysfs-tagging to a location under the sysfs topic.

Signed-off-by: John Hubbard <jhubbard@xxxxxxxxxx>

I see why you want to do this, but I have to wonder if moving them out of
Documentation/filesystems entirely might not be a better approach.
sysfs-pci.rst might better belong in the admin guide or under PCI/, while
sysfs-tagging.rst could go under networking/.

Make sense?


Absolutely, I'll post a v2 that does it that way.

thanks,
--
John Hubbard
NVIDIA