From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_NONE autolearn=unavailable autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id A5F8D7D923 for ; Mon, 8 Jul 2019 17:16:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726318AbfGHRPv (ORCPT ); Mon, 8 Jul 2019 13:15:51 -0400 Received: from mail.kernel.org ([198.145.29.99]:32876 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727373AbfGHRPu (ORCPT ); Mon, 8 Jul 2019 13:15:50 -0400 Received: from localhost (83-86-89-107.cable.dynamic.v4.ziggo.nl [83.86.89.107]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 50D2721479; Mon, 8 Jul 2019 17:15:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1562606149; bh=Kqv2Ui7O5cUGL9J6mkg9AMIciu2U6pD5nvGQlDoz+As=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=rxs57saZcKQwk+qOA7j1lnrbjw1GjQ52hlIfFX9u7wQWpwhtAcCI0R0VJTVd1bzp1 CeZuwdk0P/enR9x29GH8BH3/Liz+SVAdouwcdHSAiCNrVlRTTYUa9AXWXsv7sHd/bH 5eT83pR5u6/Dgt2XtD+A2J1uCUxi03VvbWZdXxOI= Date: Mon, 8 Jul 2019 17:16:05 +0200 From: Greg Kroah-Hartman To: Phong Tran Cc: Jonathan Corbet , Shuah Khan , 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 Message-ID: <20190708151605.GA14040@kroah.com> References: <20190705185519.31033-1-tranmanphong@gmail.com> <20190708075255.0f337b28@lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.12.1 (2019-06-15) Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Mon, Jul 08, 2019 at 10:01:13PM +0700, Phong Tran wrote: > On Mon, Jul 8, 2019 at 8:52 PM Jonathan Corbet wrote: > > > > On Sat, 6 Jul 2019 01:55:19 +0700 > > Phong Tran wrote: > > > > > Add new index.rst and change usb-help.txt format > > > to rst. > > > > > > Signed-off-by: Phong Tran > > > > 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 From mboxrd@z Thu Jan 1 00:00:00 1970 From: gregkh at linuxfoundation.org (Greg Kroah-Hartman) Date: Mon, 8 Jul 2019 17:16:05 +0200 Subject: [Linux-kernel-mentees] [PATCH] Documentation: usb: convert usb-help to rst In-Reply-To: References: <20190705185519.31033-1-tranmanphong@gmail.com> <20190708075255.0f337b28@lwn.net> Message-ID: <20190708151605.GA14040@kroah.com> List-Id: On Mon, Jul 08, 2019 at 10:01:13PM +0700, Phong Tran wrote: > On Mon, Jul 8, 2019 at 8:52 PM Jonathan Corbet wrote: > > > > On Sat, 6 Jul 2019 01:55:19 +0700 > > Phong Tran wrote: > > > > > Add new index.rst and change usb-help.txt format > > > to rst. > > > > > > Signed-off-by: Phong Tran > > > > 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 From mboxrd@z Thu Jan 1 00:00:00 1970 From: gregkh@linuxfoundation.org (Greg Kroah-Hartman) Date: Mon, 8 Jul 2019 17:16:05 +0200 Subject: [Linux-kernel-mentees] [PATCH] Documentation: usb: convert usb-help to rst In-Reply-To: References: <20190705185519.31033-1-tranmanphong@gmail.com> <20190708075255.0f337b28@lwn.net> Message-ID: <20190708151605.GA14040@kroah.com> List-Id: Content-Type: text/plain; charset="UTF-8" Message-ID: <20190708151605.e4uocv6J45lsUsB5ghTPnS07Jfr74j7sQfnAcAKY42M@z> On Mon, Jul 08, 2019 at 10:01:13PM +0700, Phong Tran wrote: > On Mon, Jul 8, 2019 at 8:52 PM Jonathan Corbet wrote: > > > > On Sat, 6 Jul 2019 01:55:19 +0700 > > Phong Tran wrote: > > > > > Add new index.rst and change usb-help.txt format > > > to rst. > > > > > > Signed-off-by: Phong Tran > > > > 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