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 DB7F71A073F for ; Sun, 15 Mar 2026 19:50:08 +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=1773604208; cv=none; b=f4fizZ+M6QkPTLIYCTzfKLwhsQikXqAg9ZRAg9YSH8viO4tepI6fWJ7beQsJgs/obuZYmhw5DGKHVqsSuNd5MKMT/Fjck5Okt51iKvEU4R8ZWxwU0QJrHppwqtq3CxQzc5b1kYAt3nzO5Yf8HPwy4obe0yd0CGRnNe2qm6pkoX0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773604208; c=relaxed/simple; bh=6eoS3LFtJRFk6+XLO2xJAlzaUGhOphBXesP3fmCa+10=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=ixIYSToPRbs4SI/FnSnas+KN0Ogi57YcxW9k6MwhI+bMQK2wJQkcbYi7IB7jDA1zaNUrFx/Bhh5w4GpvxYopBRzcpdcj4hJ3NUEW0EOKG1yLKSEbZ5Nzunrgbnf87UMczJjySuo0l1UlLI5yJPnU1aYncsrsXznZuYFcUndIA8g= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=LhJL59x4; 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="LhJL59x4" Received: by smtp.kernel.org (Postfix) with ESMTPSA id EEEBCC4CEF7; Sun, 15 Mar 2026 19:50:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1773604208; bh=6eoS3LFtJRFk6+XLO2xJAlzaUGhOphBXesP3fmCa+10=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From; b=LhJL59x4BiVtPgiSoehPCAbnyuJX/VHVBa2Lb4UR4KpKMyCGyAViGn6uZ3TcL29zZ PVoN7rdeSkCAnsAxQAuzNUO0AfHeouM/piaplzeU+iACbVtymIxWZogCXHg/RHUhE+ ibYUfEr1ujq1QVY4wny4mN5MKnv+mZrx7Tn1ATYWJrlLxVlkWcDbOfdSP1TXHBonlx njVP8q9t1HWFxwt5El0oirWIU2K6CWzWHa0Yiq9+OWkKltSmsH2aUMEA65ASEjqjMA uk7qFS3HxCuewjKTjGIFTfd0nYXxdy+LdFaAhb/kNiXNvUUkmvVdmxxKKXpszFDFEo gOvhXD8/tPYpA== Message-ID: <09920346-0caf-466f-9c12-5f086d99411b@kernel.org> Date: Sun, 15 Mar 2026 20:50:04 +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 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> From: "David Hildenbrand (arm)" Content-Language: en-US Autocrypt: addr=david@kernel.org; keydata= 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 In-Reply-To: <20260314111757.2a17c3acce8c3a1eb68ed209@linux-foundation.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit 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 So naturally, I get skeptical when it comes to "I read through the implementation, the existing comments". -- Cheers, David