From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (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 AB3F914A4C7; Thu, 25 Apr 2024 15:14:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.79.88.28 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1714058058; cv=none; b=CjPFaj16mVTT/fBBi09UCwsmNVpPVS8VTMolaGowWF/2ARtWHyuQHlUvxyrTbusOTARSXO9EN+prp0TPVBDZd5+7epY0gY+V70m0kfEog62Qi7fFoSzluYqy1b/7XNlPHyo2GeGgQS1vrrIIRcFiV9mtq5Z9euzh04gGP24cyCc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1714058058; c=relaxed/simple; bh=FI3RHSIowKSjYMHW9athi9aPj4X022XHsvU7EV9JCVQ=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=mVVNleHIxE1uNcQy2RMQ6LgDjI55zs3IM3uhOmC7t34tIHBV3X90NiIDS1ytOPT7IZjcfyeZBA7SX/N8JDsC63DPAsWGYiw85dKbnoArxOBKN9Rrm/8n/tOsjuTO9JIdNojZSL1AcALamLQqstaYXg2gfdvGhu/V0ojcWdbVLgw= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net; spf=pass smtp.mailfrom=lwn.net; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=hxId7Fkg; arc=none smtp.client-ip=45.79.88.28 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lwn.net Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="hxId7Fkg" DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 647A147C47 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1714058051; bh=zRLn1xnHbzW1iSNGc1RtWHcYvxK+sTgqStID0oZY19Q=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=hxId7FkgqOtzNRRQ6ldPYv69235a/06e/72CfMJOdsWyo9NgTl9GQmMWmoHR77ahG Aek12K4asZSA0PTTuP31n7IR36wPB83fyUKBPx/+XYc7rWq8px0u0GRr+WoRgefKOs ouazQsWZQ2bZyT+SVh6473LTXaoPpKn3lq1rDL9wL1xH00dD+8QVAMSKqPdTh/P3he i5VYGc1bQC6wKTwP04IFYFeho4oXVckzm7WstoJZXh5pAOhIUy6LvPSsoJqyyqa/Ib F6bQH26qCEOJ5SUKc5bhd8tx6jFc76CDa9awbxMf4+1fJfTUphLPTIkGWauduGutL0 ol8JMC+nQ45BA== Received: from localhost (unknown [IPv6:2601:280:5e00:625::1fe]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 647A147C47; Thu, 25 Apr 2024 15:14:11 +0000 (UTC) From: Jonathan Corbet To: Josh Marshall , "Bilbao, Carlos" Cc: ngn , linux-newbie@vger.kernel.org, "linux-doc@vger.kernel.org" , pranjal.singh4370@gmail.com, "bilbao@vt.edu" Subject: Re: Feedback on my development setup In-Reply-To: References: <7ba7cff1-8d9d-4bc3-a74c-6f6828c9195e@amd.com> Date: Thu, 25 Apr 2024 09:14:10 -0600 Message-ID: <87o79xqxtp.fsf@meer.lwn.net> Precedence: bulk X-Mailing-List: linux-newbie@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Josh Marshall writes: > Hello Carlos, > > This is a generational shift. For my peers, we understand the benefit > of keeping everything in a thread. But at some point it becomes so > verbose and cumbersome as to defeat the purpose. The size of the text > I'm working with and the number of text changes it has seen meets that > level. And so I've kept it in git and referenced that. Nonetheless, you are trying to engage with the kernel community, and will have far better results if you follow that community's norms. Those include sending patches by email and not top posting. They also include listening to the advice you are being given. Like others, I appreciate your efforts to improve our documentation; it certainly needs it! But please think about improving the *existing* documentation, rather than creating yet another file, disconnected from the rest. We already have far too much of that. Thanks, jon