[PATCH 02/22] docs-rst: convert usb docbooks to ReST

Jonathan Corbet corbet at lwn.net
Fri Mar 31 07:46:55 PDT 2017

On Thu, 30 Mar 2017 11:20:14 +0200
Markus Heiser <markus.heiser at darmarit.de> wrote:

> @Jon: what do you think about a bulk conversion?

I'm a bit leery of it, to tell the truth.  We're trying to create a
better set of kernel docs, and I'm far from convinced that dumping a
bunch of unloved stuff there in a mechanical way will get us there.

Each of those docs needs to be looked at, and, first of all, we need to
decide whether it's worth keeping or not.  Nobody wants to delete docs,
but old and unmaintained stuff doesn't help our users, IMO.  For the
stuff we want to keep, we need to look at how it fits into the new
scheme, probably split it up, etc.

It's a lot slower, but we've been getting rid of 3-6 template files in
each of the last few cycles, so we are getting there.  I don't think we
need to just give up on the rest.



More information about the linux-rpi-kernel mailing list