Am Freitag, den 31.08.2018, 16:50 -0600 schrieb Jonathan Corbet: > On Tue, 14 Aug 2018 13:43:12 +0200 > Markus Heiser <markus.heiser@xxxxxxxxxxx> wrote: > > > The documentation and TOCs are organized in a manner of a tree. Adding a > > TOC to > > the root, which refers to a file which is located in a subfolder forms a > > grid. Those TOCs are a bit confusing and thats why we get additional error > > messages while building partial documentation:: > > > > $ make SPHINXDIRS=process htmldocs > > ... > > checking consistency... Documentation/process/license-rules.rst: \ > > WARNING: document isn't included in any toctree > > > > To fix it, the *root-license-TOC* is replaced by a reference and the > > 'license-roles.txt' is added to the Documentation/process/index.rst TOC. > > > > BTW: there was an old licences remark in Documentation/process/howto.rst > > which > > is also updated, mentioning SPDX and pointing to the license-rules.rst > > So those are two separate changes and should really have been in two > different patches. I guess we can let that slide just this > once...applied. Ah, OK .. thanks! > I do have to wonder if the licensing rules are *really* the most > important thing in our docs - the thing that readers should encounter > first, before anything else. I think I'll revisit that at another time... OT: my patch was to fix the structural licensing mess. Feel free to change, what you have been applied with commit #aa19a176df95 -- Markus --
