From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BF798370D51 for ; Sun, 15 Mar 2026 19:55:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773604515; cv=none; b=PAKrnqECZt3P0ZrN5HFCMKXdYjIgVttcx2mVVbR2cRJtavsQraXzdsHESHwGoVOPiVQLxyLuXjiR8o2zuU8SqSLzLvXuu+1cfX23lf1Fc6S6c/sXsdnlR8OfIjz3wqz9Z7/0vYCamkkDHabOWuSELCE1sy7wTDOnvffgFoY5HNA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773604515; c=relaxed/simple; bh=R5ThDXaXwhDS7us7pszLF0qdYL83ZR2z6K9kBlc0xLo=; h=Message-ID:Date:MIME-Version:Subject:From:To:Cc:References: In-Reply-To:Content-Type; b=fB0wifauiIw7qHzJsLhsngjxq/W7Vxt9zj+aTvL1PPPI9gZrZa6j5vSfozHOT+px+YOdQ8d6g+Sp6zgYjFaP4MBmvjb7GUK/wLk9kjwilxC6RJKbJJimLBeU0qj6wNFXG4LnGZ935ze9PtUP/Q4omU2N4EtSOffi0W8kQhuAFY0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Ezw5Oler; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="Ezw5Oler" Received: by smtp.kernel.org (Postfix) with ESMTPSA id D1BC4C4CEF7; Sun, 15 Mar 2026 19:55:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1773604515; bh=R5ThDXaXwhDS7us7pszLF0qdYL83ZR2z6K9kBlc0xLo=; h=Date:Subject:From:To:Cc:References:In-Reply-To:From; b=Ezw5OlerE1XXx4LiBfznbun+8ECgquEmXFy3oPq5MRyV/rS1cgP4GvWp567QHecWh xTUc5d1gqM1fj/blqAN+NSTFp7/uYsCEKy879a5oik9R0e6IGu7akMx7iDCekvs++0 54rzsfOtsYFZSHtvvhjrdCoXclRsGoXlVDSnrWorBqO74BFXdD3Zlh8K/NazCUpxvu qNck6hpPLjRojREfJdpwdACax2MDMyXOtKyVyGj4Eak947vV9XPkOGn1Thh6yRSxhZ GB+AUkaGEebAWz/TJqS7nCy0segLMN+M+GX9U49whEMubxCtSaELFExj4R3w837roj jHIqkZemS44Sg== Message-ID: Date: Sun, 15 Mar 2026 20:55:12 +0100 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] Docs/mm: document Shared Memory Filesystem From: "David Hildenbrand (arm)" To: Andrew Morton , Kit Dallege Cc: Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, Mel Gorman References: <20260314152538.100593-1-xaum.io@gmail.com> <87ms0ajtvy.fsf@trenco.lwn.net> <20260314111757.2a17c3acce8c3a1eb68ed209@linux-foundation.org> <09920346-0caf-466f-9c12-5f086d99411b@kernel.org> Content-Language: en-US Autocrypt: addr=david@kernel.org; keydata= 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 In-Reply-To: <09920346-0caf-466f-9c12-5f086d99411b@kernel.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 3/15/26 20:50, David Hildenbrand (arm) wrote: > On 3/14/26 19:17, Andrew Morton wrote: >> On Sat, 14 Mar 2026 17:02:47 +0100 Kit Dallege wrote: >> >>> Hi Jon, >>> >>> The material was written with AI assistance (Claude) and then verified >>> against the source code in mm/shmem.c. I read through the implementation, >>> the existing comments, and Mel Gorman's book outline to identify what >>> should be covered, then used AI to help draft the prose, which I reviewed >>> and edited. >> >> OK, so you're saying that you created the content and used an LLM to >> assist in finishing it off? >> >>> I'm happy to rework anything that's inaccurate or doesn't meet the bar. >>> Should I add an Assisted-by tag to the commit? >> >> Yes, Assisted-by: is appropriate and useful here. >> >> From a quick scan, this material appears to be helpful and I think it >> would be good for us to get this into the tree in some fashion. Which >> will involve asking the relevant MM developers to review each change. > > So, someone with an LLM but no proven experience with the code produced > some doc, and maintainers/developers should dedicate their precious time > to do the hard work of checking everything? > > I'm all for documenting stuff, especially if newcomers start exploring > that space by contributing small, carefully crafted documentation updates. > > It's then a good learning experience for someone that wants to work on > the code to really have to understand the code in detail, and what is > actually worth documenting (and what's an implementation detail). > > I see 7 doc updates for 7 different MM subsystems in my inbox, including ... "the buddy, and for example, no mentioning of the pcp, but for some reason page isolation instead." -- Cheers, David