Re: [linux-kernel-mentees] [PATCH v5] Doc : fs : convert xfs.txt to ReST

Matthew Wilcox
2019-07-02T15:16:00Z

> +++ b/Documentation/filesystems/index.rst
> @@ -40,4 +40,5 @@ Documentation for individual filesystem types can be found here.
> .. toctree::
> :maxdepth: 2
>
> - binderfs.rst
> + binderfs
> + xfs

I don't think this makes sense. Look:

Kernel API documentation
------------------------
...
filesystems/index

but the contents of xfs.rst are not kernel API documentation. We have
precedent in Documentation/index.rst for:

Filesystem Documentation
------------------------

The documentation in this section are provided by specific filesystem
subprojects.

.. toctree::
:maxdepth: 2

filesystems/ext4/index

but that looks more like the xfs-delayed-logging-design.txt and
xfs-self-describing-metadata.txt files.

I think Documentation/filesystems/xfs.rst should be part of the
admin guide. Furtnately, ext4 has again led the way here, and
Documentation/admin-guide/ext4.rst already exists.