Em Thu, 16 Apr 2020 09:29:45 +0200 Hans Verkuil <hverkuil@xxxxxxxxx> escreveu: > 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. With the current content, I fully agree with you. However, take a look at the RFC patch I just sent. It is just the start of something (and it is not aligned yet with the latest Kconfig changes). Anyway, my plan is to add something that a random media user could find some useful information, and point to our Wiki pages where it would make sense. > > 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 > > > Thanks, Mauro
