Hi Mauro, Mauro Carvalho Chehab wrote:
Em Mon, 10 Apr 2017 16:02:54 +0300 Sakari Ailus <sakari.ailus@xxxxxxxxxxxxxxx> escreveu:Bring some order by alphabetically ordering the list of topics. Signed-off-by: Sakari Ailus <sakari.ailus@xxxxxxxxxxxxxxx> --- Documentation/media/kapi/v4l2-core.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/Documentation/media/kapi/v4l2-core.rst b/Documentation/media/kapi/v4l2-core.rst index d8f6c46..2fbf532 100644 --- a/Documentation/media/kapi/v4l2-core.rst +++ b/Documentation/media/kapi/v4l2-core.rst @@ -4,23 +4,23 @@ Video4Linux devices .. toctree:: :maxdepth: 1 - v4l2-introNACK. The order of the documentation should match what makes sense for the user that will be reading the docs, and *not* an alphabetical order.
I wrote the patch to address some of the review comments I got over the several versions of the patchset. I have no objections to maintaining the current order.
I didn't check what order you did, but for sure the introduction should come first, and then the stuff that all drivers use, like v4l2-dev, v4l2-device and v4l2-fh. Then, other stuff that it is part of the framework but are used only by a subset of the drivers. That's said, it probably makes sense to use multiple toctrees here, and add some description before each of them, in order to better organize its contents. Something similar to what it was done with Documentation/admin-guide/index.rst I'll rebase patch 6/7 to not depend on this one.
Thanks! -- Regards, Sakari Ailus sakari.ailus@xxxxxxxxxxxxxxx
