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=-3.8 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS autolearn=no 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 8F4FBC606BA for ; Mon, 8 Jul 2019 13:53:01 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 705112086D for ; Mon, 8 Jul 2019 13:53:01 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731521AbfGHNw5 (ORCPT ); Mon, 8 Jul 2019 09:52:57 -0400 Received: from ms.lwn.net ([45.79.88.28]:51448 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727401AbfGHNw5 (ORCPT ); Mon, 8 Jul 2019 09:52:57 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 888C02EF; Mon, 8 Jul 2019 13:52:56 +0000 (UTC) Date: Mon, 8 Jul 2019 07:52:55 -0600 From: Jonathan Corbet To: Phong Tran Cc: gregkh@linuxfoundation.org, 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 Message-ID: <20190708075255.0f337b28@lwn.net> In-Reply-To: <20190705185519.31033-1-tranmanphong@gmail.com> References: <20190705185519.31033-1-tranmanphong@gmail.com> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-usb-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org 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. Thanks, jon