From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Corbet Subject: Re: [PATCH] docs-rst: add input docs at main index and use kernel-figure Date: Thu, 11 May 2017 11:50:49 -0600 Message-ID: <20170511115049.160a1682@lwn.net> References: <1183dff3e0dd809c866d646a0c41ddbc4452d85e.1491904368.git.mchehab@s-opensource.com> <20170509134153.2437469f@lwn.net> <20170511074424.667effdf@vento.lan> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Return-path: In-Reply-To: <20170511074424.667effdf@vento.lan> Sender: linux-doc-owner@vger.kernel.org To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Dmitry Torokhov , Martin Kepplinger , linux-input@vger.kernel.org List-Id: linux-input@vger.kernel.org On Thu, 11 May 2017 07:44:24 -0300 Mauro Carvalho Chehab wrote: > > 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. Well, it would be nice, when possible, to put things where we want them sooner and avoid yet another move; some people get grumpy when you move the docs around too much :) That said, I know better than to believe we're going to get all of this right on the first try. Progress is a good thing. jon