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 89C7AC07E9D for ; Fri, 23 Sep 2022 19:02:09 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230194AbiIWTCH (ORCPT ); Fri, 23 Sep 2022 15:02:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43664 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230387AbiIWTCE (ORCPT ); Fri, 23 Sep 2022 15:02:04 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9F42311D0C9; Fri, 23 Sep 2022 12:02:03 -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=shcg4WjPwUQd4grLAK6y7B//HQOlI365zxAI+CXvxxY=; b=RS4B0wtrtJLyhr1dcWtKXBsjbe K89o5e0i5uHjdOzta7PHaf+vUCW7v0D4iSptCxPJGUAnn6+zSJgx8mPRNHZrAl51sr+pjVYoNrRVP pGkDn73DXmMSUsnnF2tVAWMyWECJ95MVnmhEDtoaER3Jo60Ysij3/+tetpd9ekFtbXm3Y893djlyv iPlJ1Fp6fLtvK4IPee8Le9DpCuQHA3aUzvUoycULuEZ7YMJyZFIa+jaPiNPflxOQDfkbEVYfdkgkf diXpBtEM2k5cqG0EpW3oCDFZmcBAOGgA72/HdSuo/T021yyXXzqN58/TWjtwHiGIsGXtkMfOPFKFW ISrkoYJQ==; Received: from [2601:1c2:d80:3110::a2e7] by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1obnw3-005Tle-8J; Fri, 23 Sep 2022 19:02:03 +0000 Message-ID: Date: Fri, 23 Sep 2022 12:02:02 -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 2/7] docs: Rewrite the front page Content-Language: en-US To: Jonathan Corbet , linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Thorsten Leemhuis , Kees Cook , Jani Nikula References: <20220922204138.153146-1-corbet@lwn.net> <20220922204138.153146-3-corbet@lwn.net> From: Randy Dunlap In-Reply-To: <20220922204138.153146-3-corbet@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 Hi Jonathan, On 9/22/22 13:41, Jonathan Corbet wrote: > The front page is the entry point to the documentation, especially for > people who read it online. It's a big mess of everything we could think to > toss into it. Rewrite the page with an eye toward simplicity and making it > easy for readers to get going toward what they really want to find. > > This is only a beginning, but it makes our docs more approachable than > before. > > Signed-off-by: Jonathan Corbet > --- > Documentation/index.rst | 150 +++++++++++-------------------- > Documentation/subsystem-apis.rst | 58 ++++++++++++ > 2 files changed, 111 insertions(+), 97 deletions(-) > create mode 100644 Documentation/subsystem-apis.rst I don't see a kernel version listed anywhere on the front page (maybe it depends on what theme is used?) at https://static.lwn.net/kerneldoc/, so I think it needs something like this. --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -18,6 +18,8 @@ documents into a coherent whole. Please documentation are welcome; join the linux-doc list at vger.kernel.org if you want to help out. +This documentation is for Linux kernel $(KERNELRELEASE). + Licensing documentation ----------------------- The line numbering is probably off a bit, but the big problem is in using $(KERNELRELEASE). Would using $(version) [with 'version' coming from conf.py] work here? Nope, that doesn't work either. -- ~Randy