Re: [PATCH] Documentation: usb: convert usb-help to rst

From: Greg Kroah-Hartman
Date: Mon Jul 08 2019 - 13:15:56 EST


On Mon, Jul 08, 2019 at 10:01:13PM +0700, Phong Tran wrote:
> On Mon, Jul 8, 2019 at 8:52 PM Jonathan Corbet <corbet@xxxxxxx> wrote:
> >
> > On Sat, 6 Jul 2019 01:55:19 +0700
> > Phong Tran <tranmanphong@xxxxxxxxx> wrote:
> >
> > > Add new index.rst and change usb-help.txt format
> > > to rst.
> > >
> > > Signed-off-by: Phong Tran <tranmanphong@xxxxxxxxx>
> >
> > Thank you for working to make the kernel's documentation better. That
> > said, I really don't think there is value in keeping this document. It
> > hasn't been updated in any useful way in decades, contains broken links,
> > and the links that still work are full of obsolete information. Honestly,
> > a better patch would, IMO, just delete this file.
> >
> @Jonathan Corbet it's fine to me.
>
> Need ack from you @Greg Kroah-Hartman
> if yes, I will send the cleanup patch.

All of the USB documentation needs a refresh and look again at where it
is and what it contains. After 5.3-rc1 I would recommend doing that (as
that is when all of the recent pending documentation changes will be
merged).

thanks,

greg k-h