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 C840A15530C for ; Sun, 15 Mar 2026 20:03:09 +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=1773604989; cv=none; b=T7iTAgqfjsOH8qWnwn8xJO9Hw/DMB8c0JaxzndapV/X12wmwD8boUQR2oBH2KAa7z1F1nFYp5YIJC+T1q3CqF+UY/soAUjIfVLHwBgte4dZ3it6dZ5o1cKTBJaiKPhyDWeP4+Sg9mSGYBjZ57oj7p6nPmSMPzWzEJHmZDwEW2Hw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773604989; c=relaxed/simple; bh=5EoTqlA1WXTqcUjjWB3Eb61kCIejimTFL0AFLyVl9d8=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=fFBvyccxA54gFO1BOP7X62WZIMddKsbhbrXfUnpV7et70JCrEtdJ97PnrzJTf+wLCyK9YH8ciMxwx0JXnuYGwtKUmoerrZEcQ1tyx0j8GBU+rjM5D8fx2IptRv9stfvMIQUqkuwEMBEkFI/FhRrH6N1yUSYrs9a/uWPmq94mBLU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=OxYeWLLQ; 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="OxYeWLLQ" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 99CE1C4CEF7; Sun, 15 Mar 2026 20:03:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1773604989; bh=5EoTqlA1WXTqcUjjWB3Eb61kCIejimTFL0AFLyVl9d8=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=OxYeWLLQl0LUpjvS1/O749K4IZdEisHErvtF7b4urHF+jMe1Esbsmc1nInxY/rrKj 7gyAnpCTONSsufuBgRY/jNjvSK4nJwtwnd6l7V6fnUcmMCePOazh7FHe8nHfECBDc3 990cyBMepSTDZT95/MPV77xeFsCe5WZtxLc2jEN8JNGdLauWb4YwQHqt6FUhDkK9zp Qsha7FeTxwwwzdQjtSKnoUtNDZZNRT+bRNBZDzOuTKZt7WKKTRrETfIBGKpEJyKeFC HyDCLqw4Gqi75OwpIRrICIMbYwhAz1lugRwB3BAITacoeOFmbilAWh8mLqAugsoFdv 7g2Q4MrBWHGyA== Date: Sun, 15 Mar 2026 22:03:02 +0200 From: Mike Rapoport To: "David Hildenbrand (arm)" Cc: Andrew Morton , Kit Dallege , Jonathan Corbet , linux-mm@kvack.org, linux-doc@vger.kernel.org, Mel Gorman Subject: Re: [PATCH] Docs/mm: document Shared Memory Filesystem Message-ID: 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> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: On Sun, Mar 15, 2026 at 10:00:00PM +0200, Mike Rapoport wrote: > On Sun, Mar 15, 2026 at 08:50:04PM +0100, 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 > > Heh, it's wider: > https://lore.kernel.org/all/?q=Kit+Dallege > > > So naturally, I get skeptical when it comes to "I read through the > > implementation, the existing comments". And another LLM says there are mistakes: https://sashiko.dev/#/patchset/20260314152538.100593-1-xaum.io%40gmail.com -- Sincerely yours, Mike.