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 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 16A30C07E9D for ; Fri, 23 Sep 2022 18:48:32 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232926AbiIWSsa (ORCPT ); Fri, 23 Sep 2022 14:48:30 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49180 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229821AbiIWSs1 (ORCPT ); Fri, 23 Sep 2022 14:48:27 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E8EC31205A0; Fri, 23 Sep 2022 11:48:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Content-ID:Content-Description; bh=t2OLBQEmg4AoUb1NRCujWt4eLSWl7grEqO7FcmKManU=; b=oFo0Ys/xhZAy+k9GdkSrmpOgjI 1zDdRO8+3NxQGaKeJURysOSPjtgIV0WzFW433yC0gz/Idd6slmlw6rSKrJzf4ax6LcUwQi4Gc2ePT 12SNJlK8ZK66WCJ9CQ65ffQ4yLKe0oJphtrTCED9Dz8e1gxMCynmcb7OLP68OlKziTPda0GaIw/cl 9ZOcjeJ9CWLwBcic3YTtk2eZ5t1jwkmLX9BCu75bO+/vOQy0Qncd7P3q0Q6+rlW98fp1JYz1myfYN gbcADmQKRQ9/yM1E8C/ZqqEbbhQ0vZsF0cu7lKD36XakZQA4mKldnuvHu2f6TwB8glgxjlscP7GTO 9UrA5EDg==; Received: from [2601:1c2:d80:3110::a2e7] by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1obnis-005OS9-7z; Fri, 23 Sep 2022 18:48:26 +0000 Message-ID: <0b717bbd-0b3b-ecf8-e1f5-4641491498c3@infradead.org> Date: Fri, 23 Sep 2022 11:48:25 -0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.2 Subject: Re: [PATCH v2 0/4] Rewrite the top-level index.rst Content-Language: en-US To: Jonathan Corbet , Thorsten Leemhuis , linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Kees Cook , Jani Nikula References: <20220922204138.153146-1-corbet@lwn.net> <7f02143c-461f-268b-0f17-7fe20a7423d6@leemhuis.info> <875yhep5l1.fsf@meer.lwn.net> From: Randy Dunlap In-Reply-To: <875yhep5l1.fsf@meer.lwn.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 9/23/22 06:45, Jonathan Corbet wrote: > Thorsten Leemhuis writes: > >> On 22.09.22 22:41, Jonathan Corbet wrote: >>> The top-level index.rst file is the entry point for the kernel's >>> documentation, especially for readers of the HTML output. It is currently >>> a mess containing everything we thought to throw in there. Firefox says it >>> would require 26 pages of paper to print it. That is not a user-friendly >>> introduction. >> > > Again ... who are the users? I maintain that the actual users of our > docs are primarily kernel developers. ACK! -- ~Randy