[PATCH 0/5] ext4 docs toctree reorganization

Bagas Sanjaya
2025-06-20T10:57:23Z

Hi Jon, hi Ted,

While discussing on my previous ext4 docs reorganization attempt
by merging contents [1], Jon suggested that considering current docs
file structure, a proper toctree would be ideal [2]. So, here's
the patchset that does exactly that.

Actual conversion to toctree structure is in [1/5], while the rest
is cleanups to make the resulting toctree nicer.

This patchset is based on docs-next tree.

Enjoy!

[1]: https://lore.kernel.org/linux-doc/20250618111544.22602-1-bagasdotme@gmail.com/
[2]: https://lore.kernel.org/linux-doc/87bjqjh5dr.fsf@trenco.lwn.net/

Bagas Sanjaya (5):
Documentation: ext4: Convert includes into toctrees
Documentation: ext4: Reduce toctree depth
Documentation: ext4: atomic_writes: Demote last three sections
Documentation: ext4: blockgroup: Add explicit title heading
Documentation: ext4: Move inode table short docs into its own file

.../filesystems/ext4/atomic_writes.rst | 10 ++++-----
Documentation/filesystems/ext4/bitmaps.rst | 7 ------
Documentation/filesystems/ext4/blockgroup.rst | 11 ++++++----
Documentation/filesystems/ext4/dynamic.rst | 10 +++++----
Documentation/filesystems/ext4/globals.rst | 15 ++++++++-----
Documentation/filesystems/ext4/index.rst | 2 +-
.../filesystems/ext4/inode_table.rst | 9 ++++++++
Documentation/filesystems/ext4/overview.rst | 22 ++++++++++---------
8 files changed, 49 insertions(+), 37 deletions(-)
create mode 100644 Documentation/filesystems/ext4/inode_table.rst

base-commit: d3f825032091fc14c7d5e34bcd54317ae4246903