On Tue, Jul 10, 2018 at 10:16:42AM -0700, Darrick J. Wong wrote: > Hi all, > > This series converts the existing in-kernel ext4 documentation to rst > format, links it in with the rest of the kernel's rst documetation, and > then begins pulling in the contents of the on-disk layout page in the > wiki. No changes are made to the text during the import process except > to flatten the nested tables in the old wiki page, which were very > difficult to maintain. > > I've built the docs and put them here, in case you hate reading rst: > https://djwong.org/docs/kdoc/filesystems/ext4/index.html I've applied these patches, but I think we still need to do some work figuring out how to integrate the ext4 documentation into the Linux-doc tree as a whole. At the moment they are dropped in the middle of the "Kernel API Documentation", by virtue of where the files are located. Most of the ext4.rst file probably should be moved into the user's and administrator's guide. I'm not sure where the best place to put the ondisk documentation. It's probably not the user's and administrator's guide, but the Kernel API Documentation doesn't seem like the right place. But it should also make sense when people are browing the Documentation source directories, too. I'm not sure what the best way to do that might be, but maybe some of the folks on the linux-doc list will have some suggestions. Cheers, - Ted
