On 16/04/2020 09:21, Mauro Carvalho Chehab wrote: > Em Thu, 16 Apr 2020 09:01:55 +0200 > Hans Verkuil <hverkuil@xxxxxxxxx> escreveu: > >> On 14/04/2020 15:37, Mauro Carvalho Chehab wrote: > >>> ================================ >>> Linux Kernel Media Documentation >>> ================================ >>> >>> .. toctree:: >>> :maxdepth: 4 >>> >>> admin-guide/index >>> driver-api/index >>> userspace-api/index >> >> Wouldn't it make more sense to have the userspace-api before the admin-guide? > > There, I just placed them on alphabetic order. > > But answering your question, that depends on the audience ;-) > > - > > Yet, assuming that we are doing a good job, I would expect a lot more > users than developers[1]. If you want to see what it looks like with userspace-api on top: https://hverkuil.home.xs4all.nl/spec/index.html I think it makes more sense that way. Regards, Hans > > [1] Granted, there are lots of gaps there for it to be a generic guide > to media subsystem. I'm planning to improve the admin-guide in order > to make it more consistent and useful for media users. > > The order there, IMHO, doesn't matter much, as someone accessing it from > LinuxTV.org would likely use this URL: > > https://linuxtv.org/docs.php > > Side note: I need to add a pointer to the admin guide there - and at the > wiki pages. > > Thanks, > Mauro >
