From: Jonathan Corbet <corbet@lwn.net>
To: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
Mauro Carvalho Chehab <mchehab@infradead.org>,
Dmitry Torokhov <dmitry.torokhov@gmail.com>,
Martin Kepplinger <martink@posteo.de>,
linux-input@vger.kernel.org
Subject: Re: [PATCH] docs-rst: add input docs at main index and use kernel-figure
Date: Thu, 11 May 2017 11:50:49 -0600 [thread overview]
Message-ID: <20170511115049.160a1682@lwn.net> (raw)
In-Reply-To: <20170511074424.667effdf@vento.lan>
On Thu, 11 May 2017 07:44:24 -0300
Mauro Carvalho Chehab <mchehab@s-opensource.com> 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
prev parent reply other threads:[~2017-05-11 17:50 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-04-11 10:01 [PATCH] docs-rst: add input docs at main index and use kernel-figure Mauro Carvalho Chehab
2017-04-11 20:54 ` Jonathan Corbet
2017-04-12 9:49 ` Mauro Carvalho Chehab
2017-05-09 19:41 ` Jonathan Corbet
2017-05-11 10:44 ` Mauro Carvalho Chehab
2017-05-11 17:50 ` Jonathan Corbet [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20170511115049.160a1682@lwn.net \
--to=corbet@lwn.net \
--cc=dmitry.torokhov@gmail.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-input@vger.kernel.org \
--cc=martink@posteo.de \
--cc=mchehab@infradead.org \
--cc=mchehab@s-opensource.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.