Re: [PATCH] docs-rst: add input docs at main index and use kernel-figure

[Mauro Carvalho Chehab <mchehab@s-opensource.com>]

Em Tue, 9 May 2017 13:41:53 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Tue, 11 Apr 2017 07:01:19 -0300
> Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
> 
> > The input subsystem documentation got converted into ReST.
> > 
> > Add it to the main documentation index and use kernel-figure
> > for the two svg images there.
> > 
> > Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
> > ---
> > 
> > Jon/Dmitry,
> > 
> > This patch contains the final bits of the input documentation
> > conversion. The linux-input tree has already the ReST conversion
> > patches, but it doesn't have the
> > Documentation/sphinx/load_config.py script with implements
> > the kernel-figure directive, as it got merged via docs tree.
> > 
> > So, either one of you should merge from the other tree or this
> > patch should be sent in separate upstream after both trees
> > gets merged. What do you prefer?  
> 
> This is now applied.

Thanks!

> I do reserve the right to break apart and reorganize this documentation,
> a bit; it's got the classic problem of jumbling stuff for different
> audiences into one big document.  But that's for another day when I have
> some time...2022 or so...

Yeah, it makes sense to better organize things, but I suspect that,
if we do that after converting everything to ReST, it would be easier
to identify what would be the best way to group the documentation
per audience.

Thanks,
Mauro