----- Ursprüngliche Mail ----- >> Why mark this "orphan" rather than just adding it to index.rst so it gets >> built with the rest of the docs? >> > I've no idea of rst and the ubifs-authentication.rst which I had open at the > time did have this as well, so I blindly copied it. Thanks for spotting, will > remove in the next iteration. Well, the original ubifs-authentication documentation was written in in markdown (which is IMHO muss less pain to write), later it was converted to rst by: commit 09f4c750a8c7d1fc0b7bb3a7aa1de55de897a375 Author: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx> Date: Fri Jul 26 09:51:14 2019 -0300 docs: ubifs-authentication.md: convert to ReST The documentation standard is ReST and not markdown. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx> Acked-by: Rob Herring <robh@xxxxxxxxxx> Signed-off-by: Jonathan Corbet <corbet@xxxxxxx> But I have no idea what this orphan thingy is. Thanks, //richard