On Wed, 2025-11-05 at 20:04 +0700, Bagas Sanjaya wrote: > On Tue, Nov 04, 2025 at 10:32:50PM -0500, James Bottomley wrote: > > On Wed, 2025-11-05 at 08:57 +0700, Bagas Sanjaya wrote: > > > On Tue, Nov 04, 2025 at 09:55:08AM -0500, James Bottomley wrote: > > > > On Tue, 2025-11-04 at 20:13 +0700, Bagas Sanjaya wrote: > > > > > The last section heading in TPM security docs is formatted as > > > > > title heading instead. As such, it shows up as TPM toctree > > > > > entry. Demote it to section heading as appropriate. > > > > > > > > It's supposed to be a separate heading. It's explaining how to > > > > certify your booted kernel rather than describing TPM security > > > > within the kernel. > > > > > > Should I keep the whole section as-is or should I move it to > > > separate docs? > > > > Why might it need moving? > > Just to tidy up toctree then...
I'd really rather have the files in the doc tree grouped for ease (and reminder of) maintenance. The two headings belong together in one file because if someone updates the doc for one, there's at least a chance they'll notice the other might need an update as well; whereas if we do separate files for every heading the tree becomes very fragmented and the chance of something being missed increases. Regards, James
signature.asc
Description: This is a digitally signed message part
