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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id C89E8EB64DA for ; Sun, 18 Jun 2023 18:55:01 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id E3A826B0071; Sun, 18 Jun 2023 14:55:00 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id DEAD06B0072; Sun, 18 Jun 2023 14:55:00 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id CB2F06B0075; Sun, 18 Jun 2023 14:55:00 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id BC57A6B0071 for ; Sun, 18 Jun 2023 14:55:00 -0400 (EDT) Received: from smtpin26.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 8B060A030F for ; Sun, 18 Jun 2023 18:55:00 +0000 (UTC) X-FDA: 80916770760.26.509E246 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf18.hostedemail.com (Postfix) with ESMTP id C49AA1C000A for ; Sun, 18 Jun 2023 18:54:58 +0000 (UTC) Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=P8upKCnY; spf=pass (imf18.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1687114499; a=rsa-sha256; cv=none; b=EhJrIm1FXsP7SVTLcF1prnPyCNcbBOhZUSbKSGSnsUOT1/OB6oVs3P67ZZL5lAv/V2cFgK PDHsykbFwtHew65a9dyR0qsr10TGPPTvughdmOUbui6cv6Lu7wu6z83iiu7kITRoXwY5Mi Kc4Q3I8zHulqZ7K+gtI7SsceyLTN40k= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=P8upKCnY; spf=pass (imf18.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1687114499; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=DzxsAMuZ7ZP4niSDsH+A8h51O/GHUccOcld3SSNEPbg=; b=NYw3vHTavfUo00vXn323hZQEbn126pZhSqufeGxWWtC293tMT1271pcY8juUVbazLPhlfz e/4rVlxHCb8TTAMm3T5ez9icjF392j5D7QE2pXUEdAfxNYGdPGsOFUY8YGfpo6IZm+6yn4 /nssD3ZDlIBLHkjES0RkEs0eMsbbKcs= Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (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 A8840723; Sun, 18 Jun 2023 18:54:56 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net A8840723 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1687114496; bh=DzxsAMuZ7ZP4niSDsH+A8h51O/GHUccOcld3SSNEPbg=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=P8upKCnYXiwUC1I9xTPaotzuvAsFRHfoWqPEWuwHjAcD22wIBTX/c0r0TqnoL+v19 kBOkBJ4AyQkikk7Xv6OvlqoUZP3d6wvXZU/9RwQSsjNqtSpuXQ8cp36HyccdfY99ha qU4ZBUsWNSgrMEuQ7+wKepzvZUXgXgEdU3knr+AaqoBrXXkIz5i6N1bGuMHhxZWXdb io246UmSzlGE/TSwedIvXkIcQrR50qOasnnYI/GK1tJ8B4D1QN1b1cmo1ACY6qgjHB CiQqqD6NxrZmsZo0D1RHDMVA6efvjX8OSmTQmXFOwjHn0hmw91s7wgQ0+/fAly68zE nG3jsdCdq9Qhw== From: Jonathan Corbet To: "Fabio M. De Francesco" , Andrew Morton , Linus Walleij Cc: linux-mm@kvack.org, linux-doc@vger.kernel.org, Linus Walleij , Matthew Wilcox , Randy Dunlap , Mike Rapoport , Jonathan Cameron , Bagas Sanjaya Subject: Re: [PATCH v5] Documentation/mm: Initial page table documentation In-Reply-To: <3045029.CbtlEUcBR6@suse> References: <20230614072548.996940-1-linus.walleij@linaro.org> <3045029.CbtlEUcBR6@suse> Date: Sun, 18 Jun 2023 12:54:55 -0600 Message-ID: <87zg4wvbwg.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: C49AA1C000A X-Stat-Signature: e5eat3o8qr63cx7t3jb4puo1b9sno6qh X-Rspam-User: X-HE-Tag: 1687114498-440095 X-HE-Meta: U2FsdGVkX18K2tQkciSo5DUPd87i69oYifkdHAGhQTXOfe4xGc1KArcMpgKFEzpUGF367GbPz56EYvmiD39vry2H8leh4zx0AFOunmC8e2aO0Q4OZ0ICVZCe5gjTc3NBln7pCcyBQKDYA9WcdG3L9HEedX/tOVovCHyNbsuciY03U6wX2kmiGWVcb1gHJ2TD7KQ9tavHUmYKalJ32Wh3ZfFyuVT/mZ4v2aFKmn7l8B4j/Jnu4RMJSPggWhze22jVU290xyJtANBUqKWeJcBzuBzPHatSYVE/OZdpcDdD6XesazlDmPlcs42JqqptGneKB2tdqBYjmgtR8cXHCRVExf9lp4oxE8DJVZPcfN169MGGbjNAMbYL1oQB7R1lOUsqdjJEbxE0k9bFM9I0Wmc8l220Yvx12dDDEJ3cttE28gYGtvxWkITPJ/Deb/FN+T64nyrlzKaG62eaYAAgd57pO4/+BuqfaZ63E/EKeihvHyvCTJXGSJC4t1MQGcKPZTXcTurx0MWaTyxPYw2Z9VF9Oi2045e26eOdSeQx49GHl6Q89LVrFrDQCc7tKjlE/iUj0ypmAGaMpO4chJ4Jif36JrLq6iGTf52KlEcESr00MqMJhSNmkOr+Itdi+WSe1YKV+bexZER/c7Q5d1cojS5qQU7DdVXiQSP0kw4DMRjjfHuCljQjC5OBcssKnxTkzp92oVRmug7SN4pluA3yyaS2Kw9WKZnXy6LIEhxR9OHXl1xz5DL72VY3JS4iksYPq7dSwMBBMoYr3fNORzon02HgXVvvNiOB3Nq/Vk0qSK0y9ocmQaI/KsDPrNHxBiehyKZB4kmyl1WFs2SEGDN6RrmH8yhc0tOzB+GZA1/UoqMXWCRhhmKXkDpb/S+cvHzqXXz272xjnAhiluDGSJJeA0FoSEYRX+47g8jqoR4oZAiZbytiSEqtto/VluajH0umyULwt8rWNyXZzQ4FENXayy2 6e1Eh0bw CatC8Tp6szlffPBHZ7m3aDNF77SrtyA1hwIPZkTNOn7naKQlix0rQj275s9+9zVwysEAqDqGxFsZOUoltVrjpknxw/z2lC8SXorpzxPqI+lWJrdBu9fPgRf6gG6+5ILuLGA0Qe6tRLXnYEfrCfZC+7ItQ37umX/VQaK0PUnxfKjRtrH9xfg5bPyqNX1+6dw2W3ZJ6AF2+1YOGIU4= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: "Fabio M. De Francesco" writes: > I question the target audience of this documentation. How can we expect a= ny=20 > developer working with Linux to be unaware of such basic concepts? Adding= =20 > documentation about these foundational concepts would create a precedent,= =20 > potentially leading to further documentation on other fundamental abstrac= tions=20 > like "task," "multi-threading," and "scheduling" =E2=80=93 concepts that = are integral=20 > to kernel management. The inclusion of such basic topics could quickly cl= utter=20 > up the specialized Linux kernel documentation. Someday, if we find ourselves in the position of having too much documentation, we can entertain patches to clean out material that is deemed to be too elementary for kernel developers. Before then, though, if we are worried about clutter, we may want to put more effort into addressing the large amount of duplicated and obsolete documentation in the kernel now. Until then, I see no reason to oppose the addition of material that, even if you don't personally find it helpful, may indeed be helpful to developers trying to come up to speed on just what the kernel is doing. Thanks, jon