From: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
To: Phong Tran <tranmanphong@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>,
Shuah Khan <skhan@linuxfoundation.org>,
mchehab@kernel.org,
linux-kernel-mentees@lists.linuxfoundation.org,
linux-usb@vger.kernel.org, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH] Documentation: usb: convert usb-help to rst
Date: Mon, 8 Jul 2019 17:16:05 +0200 [thread overview]
Message-ID: <20190708151605.GA14040@kroah.com> (raw)
In-Reply-To: <CAD3AR6EN7n5KXnJqW0UdgB_eQjuTedB6KdC8sJ_h+MJNKB6ZmA@mail.gmail.com>
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@lwn.net> wrote:
> >
> > On Sat, 6 Jul 2019 01:55:19 +0700
> > Phong Tran <tranmanphong@gmail.com> wrote:
> >
> > > Add new index.rst and change usb-help.txt format
> > > to rst.
> > >
> > > Signed-off-by: Phong Tran <tranmanphong@gmail.com>
> >
> > 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
WARNING: multiple messages have this Message-ID (diff)
From: gregkh at linuxfoundation.org (Greg Kroah-Hartman)
Subject: [Linux-kernel-mentees] [PATCH] Documentation: usb: convert usb-help to rst
Date: Mon, 8 Jul 2019 17:16:05 +0200 [thread overview]
Message-ID: <20190708151605.GA14040@kroah.com> (raw)
In-Reply-To: <CAD3AR6EN7n5KXnJqW0UdgB_eQjuTedB6KdC8sJ_h+MJNKB6ZmA@mail.gmail.com>
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 at lwn.net> wrote:
> >
> > On Sat, 6 Jul 2019 01:55:19 +0700
> > Phong Tran <tranmanphong at gmail.com> wrote:
> >
> > > Add new index.rst and change usb-help.txt format
> > > to rst.
> > >
> > > Signed-off-by: Phong Tran <tranmanphong at gmail.com>
> >
> > 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
WARNING: multiple messages have this Message-ID (diff)
From: gregkh@linuxfoundation.org (Greg Kroah-Hartman)
Subject: [Linux-kernel-mentees] [PATCH] Documentation: usb: convert usb-help to rst
Date: Mon, 8 Jul 2019 17:16:05 +0200 [thread overview]
Message-ID: <20190708151605.GA14040@kroah.com> (raw)
Message-ID: <20190708151605.e4uocv6J45lsUsB5ghTPnS07Jfr74j7sQfnAcAKY42M@z> (raw)
In-Reply-To: <CAD3AR6EN7n5KXnJqW0UdgB_eQjuTedB6KdC8sJ_h+MJNKB6ZmA@mail.gmail.com>
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 at lwn.net> wrote:
> >
> > On Sat, 6 Jul 2019 01:55:19 +0700
> > Phong Tran <tranmanphong at gmail.com> wrote:
> >
> > > Add new index.rst and change usb-help.txt format
> > > to rst.
> > >
> > > Signed-off-by: Phong Tran <tranmanphong at gmail.com>
> >
> > 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
next prev parent reply other threads:[~2019-07-08 17:16 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-07-05 18:55 [PATCH] Documentation: usb: convert usb-help to rst Phong Tran
2019-07-05 18:55 ` [Linux-kernel-mentees] " Phong Tran
2019-07-05 18:55 ` tranmanphong
2019-07-08 13:52 ` Jonathan Corbet
2019-07-08 13:52 ` [Linux-kernel-mentees] " Jonathan Corbet
2019-07-08 13:52 ` corbet
2019-07-08 15:01 ` Phong Tran
2019-07-08 15:01 ` [Linux-kernel-mentees] " Phong Tran
2019-07-08 15:01 ` tranmanphong
2019-07-08 15:16 ` Greg Kroah-Hartman [this message]
2019-07-08 15:16 ` Greg Kroah-Hartman
2019-07-08 15:16 ` gregkh
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=20190708151605.GA14040@kroah.com \
--to=gregkh@linuxfoundation.org \
--cc=corbet@lwn.net \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel-mentees@lists.linuxfoundation.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=mchehab@kernel.org \
--cc=skhan@linuxfoundation.org \
--cc=tranmanphong@gmail.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.