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 5DEC3C77B7D for ; Sat, 13 May 2023 11:21:25 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6EA346B0071; Sat, 13 May 2023 07:21:24 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 6729F6B0072; Sat, 13 May 2023 07:21:24 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 4EB966B0074; Sat, 13 May 2023 07:21:24 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 3A6A06B0071 for ; Sat, 13 May 2023 07:21:24 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id F0616161068 for ; Sat, 13 May 2023 11:21:23 +0000 (UTC) X-FDA: 80784990846.09.97B27A1 Received: from mail-wm1-f54.google.com (mail-wm1-f54.google.com [209.85.128.54]) by imf28.hostedemail.com (Postfix) with ESMTP id 23967C0006 for ; Sat, 13 May 2023 11:21:21 +0000 (UTC) Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=q06FPrVL; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf28.hostedemail.com: domain of lstoakes@gmail.com designates 209.85.128.54 as permitted sender) smtp.mailfrom=lstoakes@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1683976882; 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: in-reply-to:in-reply-to:references:references:dkim-signature; bh=rnZoqVihAefPaQj5DHnjIJBqO4/XW9d3KJwCAhQfWa8=; b=WehVvNthO4K327MnzdGV5qk1mNfn7sNAMo05+cTkRPNpBg15ru79z3GHeRV0aGikMGQ8h+ Xtg2AVHPqA1dxQkDdqk8ZkLu7OVeUprT3/SZoCEK508BWX+UkF+bpPR4OKfZ833riZEXfH qE2IrynrN9bD9HTjiCZOeTCBSkpm7XI= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=q06FPrVL; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf28.hostedemail.com: domain of lstoakes@gmail.com designates 209.85.128.54 as permitted sender) smtp.mailfrom=lstoakes@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1683976882; a=rsa-sha256; cv=none; b=4l4sTCTfZuLB6fXfWnUdvhsoB01KwHoF9MIU9/+sw71dVu7S6Divy37QYpbgOUhCHjXHi9 LabAbpWJaPNHt/WvwZUXgbf0QhZXCruf+/ZWd/J2wfqrphNSdPx/M5C0RDHnGN1/e1ZBwh /9mYRYoQZ2gB3uIK2l1ZTX57EnI6p2M= Received: by mail-wm1-f54.google.com with SMTP id 5b1f17b1804b1-3f475366522so27863945e9.1 for ; Sat, 13 May 2023 04:21:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1683976880; x=1686568880; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=rnZoqVihAefPaQj5DHnjIJBqO4/XW9d3KJwCAhQfWa8=; b=q06FPrVLZ283AlAerXen96GP6+hW7mvYtabl/T+EoptavI1aWju20ahR0PMZfTftZr BOgBOC6LJ0+AHFP2tRapQlcW1cJikNwRx+HR88HU3KaTUm6wXQYgxOD1TdzJs1QTh7SW FYuYTAc6ZlRypyA7BjzimnBuUmrAsIc4SXS/qUhYL0S+kslSM30U6Zirml9eh0wfVNdZ NmaUtAZvLO5ctSHfZq9OnwgDd9JaaHN4H/X92turylHh6BZ2o8YXwFdk0gh81mmpEUHv OKdm6Z4eGCS1fUw1utVv3FNKFts1BKT3LQ+AEff6hT3s/OwGtZzpISvRMM334VSMr5Na ppuQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1683976880; x=1686568880; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=rnZoqVihAefPaQj5DHnjIJBqO4/XW9d3KJwCAhQfWa8=; b=DT6c6iX27x3ujvuFJWEnp/ruUDQ7Ua2THjq2sGbe7z6eme1nPPnKoLJCOhFCO/cc4C EVwR0cwDtwenZuxZ7dJuWwIsZXgNkV3W/OXl4WtOmfouvRLlVZ+4C8TH/ZbncgC7hoon 6jenZtF+N3JInNkbMAe+9RhnzdsJ+oEdnspGzyVjIOWFDlIq3co3/kst1asD0B384nEF ZkcGmHZzmiQMZk6ZCzQ+gkDSNR+W6Q9Xc0FJk2vuxvka0TQFoC+jObunVvcFEg1DyMUX WvfxQ2AjSmY+kydBYEX2yi0T+CZDZmffQ26fmXiPrkRo3BxmJbSpSH0aepkYiwAQ6xI8 2WFQ== X-Gm-Message-State: AC+VfDzya4wqweZFuDijXzDY46vB2BP42iYo7R6fatR3CdkT1T67xyK2 juzGCWV7DLZc7EXOSQgQ0gw= X-Google-Smtp-Source: ACHHUZ5/uNxn3A35wJtx/xp/KdgY/A8r0dY0Bvf2s7QRhzl7ramal9SOLOUhH2TeaHzj4FVIOrVqiQ== X-Received: by 2002:a05:600c:2942:b0:3f4:bef6:5a55 with SMTP id n2-20020a05600c294200b003f4bef65a55mr7771791wmd.16.1683976880107; Sat, 13 May 2023 04:21:20 -0700 (PDT) Received: from localhost ([2a00:23c5:dc8c:8701:1663:9a35:5a7b:1d76]) by smtp.gmail.com with ESMTPSA id u5-20020a05600c210500b003f427cba193sm16276607wml.41.2023.05.13.04.21.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 May 2023 04:21:19 -0700 (PDT) Date: Sat, 13 May 2023 12:21:18 +0100 From: Lorenzo Stoakes To: Mike Rapoport Cc: linux-mm@kvack.org, Matthew Wilcox , Jonathan Corbet Subject: Re: [LSF/MM/BPF TOPIC] mm documentation Message-ID: <5aa1cb82-b39e-47c9-bb7a-c6145b2acbd3@lucifer.local> References: <20230512173732.GI4135@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20230512173732.GI4135@kernel.org> X-Stat-Signature: x4mqq4w9gumrurx19r6g45gh3cwxuqdx X-Rspam-User: X-Rspamd-Queue-Id: 23967C0006 X-Rspamd-Server: rspam07 X-HE-Tag: 1683976881-815415 X-HE-Meta: U2FsdGVkX19Koxkzfh97Cm0biSbZDw3Vxs2PLl/JfzMBjSM5ysAStEg5PIHBPjq1Hg14V8Fu9vrb2lEH4DkgCqx1fuCUylo32Tsdh4OLwxzBmIwzg9Xio6vTBnVkwhZXmw9QnGidq1m5iXBqkSv7Tz+shhe5qz814qB1ZRe3zWmaJoeXkNrpmUCMEvCxrLezSKwmIJ15LoZvz4uimXFI839y8BQ52DRjxPJaNhujNcykp+agDHYFwvFj+QkvPJ0RXP6yH4rXS6QRsi1ASD/8JbwHH4BP/i3/LwOnT4Yf8IrCIHp1TMEvA1ODWaNC29Za4efTHp1sqs2I/lD1d7RD9Iedsa336iKUdTvaNJQM+NaR3JEuU7OW072B9xybv5nkOyjCJg184zI0rFdKGs2BYcopvsaOHL+ziEY3j0V5MnNqPWf/VKNPcYJAZCAzKUAwLlQROTqZNrMKfjfjlfTvSVlqLF4CvAUlDVoVmbZz3q1kXzE52T63Wqm0UVoSmlGOhv6FnfYwJfMzbecrQSKdC36Y3EqUH8WDlWwUk6ZH529WiMgnai2w5uHAajmZYJMUfvaxm1AO/uMbLq0ruyFZTk67oji9JDizZmWbACcNwp86J3kKMxePDcpfE+7lsVo9FwYdnVIjUAczBn1c8nmpZhYrpq0vr461KWJ8ZyA6dALGfoTqDDDEx4SmqmP+u4FR7yD59tIdmENLFDL/5Y8fmoe54uvibR2PAfnoiwbvU7UVBQ2DdqBZXISE5LOdfjd5XQSDzmkAAQ84rhDWCLjiKXh57JTZ8Wa09qfB+m45sFFcMp1sbITFR8F4f323VRq5e2QyF/FguoOZ4teb2eN1eNeT4uehIxI03ZSqj/DTgcXCQN/OA4IZ07zIWba0Y8UatwGBbs6cj3+eZS/oYAu5/lpBe9XFGKvrM+Fp9gGEvMxCmG6A1jJTKyc4+/9UaGamaP7Ma6jqZsRYPkVw4Jh fnntL5zy 4eSViukzwYqqVNsoZzi/lpUkbXORdCn6+VwluzntAmtKwggAc58qFyx/nRN1/9Sn4jfP6b4UaHFdwmA5LvWAuPv9gt9HqnCBaIrQhniKlNmDnkgs3KfF6cvI7VAv5oez2r88lNSYKT7HS4p/YyPHcFrZT5teSSt/06fLLnZnuwpwwowJRkj4WYCLGyb/u8HkUNfJf7UrgR8YghepxHPKtzY926Y0qvBku86KehgwRCljIiUAasxIIv/H8s/2dF6tbz1fThDcQmtnsUsqtiy06FlDZW4kaXxg2vbx797q3M/8ghEuEcRO5GLpE3WBTkDEzn9TYT7xkOU8joVNQAN0SHNE3WGkOQ/gVFXcQkGZTPkd9sjoywtQB98n0ScWbV/Rhn6ZaYAjI0GnveU5LxIdniWuRm3D3M5S3t4al5klXrf6ycC+16rH7HL9F91V4kZzgK9Q42jRy+xcQDyQ= X-Bogosity: Ham, tests=bogofilter, spamicity=0.008935, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On Fri, May 12, 2023 at 10:37:32AM -0700, Mike Rapoport wrote: [snip] > If you are comfortable with random people taking your work and adjusting it > to fit into Documentation/mm, I think there are a few ways to move this > forward without requiring you to do the actual work. > Yeah I'm not against that for snippets of the work, I do think that a large chunk of the book isn't quite so useful (the parts that are more code commentary), but there are definitely descriptive elements that are more suited. > First, I'm ready to give it a try and see how much effort is required for > LaTeX to rst conversion and what are the changes that need to be made to > the content. Maybe others in the community would be able to contribute too. > Thanks, I will try to pull out some bits that I think might be useful. I could even try converting some myself as a starting point. I wonder if a 'staging' area in the docs section could be useful? ;) > Next, if people ask about entry level MM projects that's something that we > can suggest as well. > > And if we are going to participate in projects like Outreachy and Google > Season of Docs, we can suggest a project "Convert Lorenzo's book to kernel > documentation" alongside "Write more MM documentation" project. > Yeah, this could be a good starting point actually, as rather than starting from zero, people would have some material that they can cross-check. > > Also, as always, I am happy to send the current WIP book to anybody in > > MAINTAINERS if they would like to take a look! > > > > Relatedly, I am shortly going to be working on the page cache chapter, > > Willy - I wondered if you would like to take a look when I am done > > with that? > > > > Cheers, Lorenzo > > > > [1]:https://ljs.io/merge_cases.png > > > > > -- > > > Sincerely yours, > > > Mike. > > > > > -- > Sincerely yours, > Mike. >