From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.3 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6C1FBC606BD for ; Mon, 8 Jul 2019 17:15:55 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 4275C21479 for ; Mon, 8 Jul 2019 17:15:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1562606155; bh=Kqv2Ui7O5cUGL9J6mkg9AMIciu2U6pD5nvGQlDoz+As=; h=Date:From:To:Cc:Subject:References:In-Reply-To:List-ID:From; b=uVvdVpDovNlLEFyCq7jNoir79akLiWpV3RfWdt1wshWNUmJCqR78KGx93wO+Ur3+c tyfeRnq0ERGHkgZmnxqXMFjtJYX3R20x0MG54gy2pFxJ76Bjvwsaxf84o/Bw1r7MDF rduA1o2pcIu0pmA3VNfpwtSQ1nWK5hThlHRDl0Uc= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730817AbfGHRPv (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-usb-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-usb@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