On 16/04/2020 09:55, Mauro Carvalho Chehab wrote: > 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. But that's only useful for people who need to build their own kernel or do other admin tasks. That's a small group and it is usually a one-off thing. The vast majority is interested in the public APIs. Regards, Hans > >> >> 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 >
