Re: [PATCH 0/4] Slurp (squash) ext4 subdocs

[Bagas Sanjaya <bagasdotme@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 1115 bytes --]

On Thu, Jun 19, 2025 at 01:56:48PM -0600, Jonathan Corbet wrote:
> Bagas Sanjaya <bagasdotme@gmail.com> writes:
> 
> > Let's slurp (squash) the subdocs instead. This will make the master docs
> > larger of course (although not as big as KVM API docs), but one can use
> > cross-reference labels without hitting aforementioned warning bug. Also,
> > docs directory structure is tidier with only 4 files (master docs and
> > about.rst). As a bonus, also reduce toctree depth as to not spill the
> > whole hierarchy.
> 
> "slurp" is not exactly a technical term that will make sense to readers
> of the changelogs.
> 
> But, more importantly... Might it be that the current file structure
> reflects the way the authors wanted to manage the docs?  It seems to me
> that just organizing the existing files into a proper toctree would be
> rather less churny and yield useful results, no?
> 

Agreed. The toctree approach was indeed my first thought ([1]).

Thanks.

[1]: https://lore.kernel.org/linux-doc/aEpAD2jcemzvoJlQ@archie.me/

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]