On Tue, Jul 02, 2019 at 01:30:40PM +0100, Sheriff Esseson wrote: > +++ 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.