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 4020229408 for ; Thu, 14 May 2026 01:46:29 +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=1778723190; cv=none; b=MW96BNJibZz+4iV4bDMUbTQcCLyoeNTerVfVCV68le89JNzUP8luPbx6dn/ceHH71mhvXxR8PO3KJi98bcI8wNPiQoyxbGv8G65LxhQrFF5yUyUIwpdhi9lRKGSu+Bkg9PPvoE8U52N8aJifXpH4MjxFMi18LRIr4cQTZpDuJ5s= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778723190; c=relaxed/simple; bh=jeD1+dCl+u6SDIGS1YampC5RF7h87L51rODLaEisiTc=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=sMeklwSZPIMGmluwJCFwH0/oydao6SGKhKL5GDKO2RtTp7I7De6xHckJnCz78WShjxbDAEhnFtkMfz3ArYbdFJO7AbkwJQ2iqG9uMKZfVWBNfcVHNNzNL9t9O3xmSu/E8VQR2jTFTlbK2xrbym4V+8DCYJIKUj2vtbnCfPdA4iM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=TbxG8qAg; 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="TbxG8qAg" Received: by smtp.kernel.org (Postfix) with ESMTPSA id D6024C2BCB3; Thu, 14 May 2026 01:46:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1778723189; bh=jeD1+dCl+u6SDIGS1YampC5RF7h87L51rODLaEisiTc=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=TbxG8qAglqLhnCU3cSu8ztGvkk5RshZjAOXp61ce1KhL2QAI076d69B0z8sKXHArI j99/rVM3ztNWg/Xy3rK7i5nXAlUQ0CFngFDcurENHArNu5dyiXlxMV/ov4Sc7BmFaI /UbNL+WHf2AgfqjuyQWL+Yg76nu6wEi2xSA8UJqA6xlYxiJHx5T4QLy4ZmEU4cDov7 XH+hoxwVOJYbEI4aUBssBoTmk4B+HFI6Rz6aOGeEokW0EZAi9uMC0F1moi2HPJhUT3 /Jq/gKvbIyDJM2s1axKVE+kGTefbL9vzUG/5QVbyb9zgm+3zihLE0OpM1WvGzno5Iu fjaxpOwhMbYhQ== Date: Wed, 13 May 2026 18:46:29 -0700 From: Kees Cook To: Runxi Yu Cc: Jonathan Corbet , Sasha Levin , Randy Dunlap , Runxi Yu , SeongJae Park , linux-kernel@vger.kernel.org Subject: Re: [PATCH v2] README: Don't organize the README by arbitrary "roles" Message-ID: <202605131844.085EF96F@keescook> References: <20260514000954.32172-1-me@runxiyu.org> Precedence: bulk X-Mailing-List: linux-kernel@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: <20260514000954.32172-1-me@runxiyu.org> On Thu, May 14, 2026 at 12:09:46AM +0000, Runxi Yu wrote: > More broadly though, I'm a little skeptical in whether the README is the > proper place to put extensive links to different subsystems/parts of the > documentation. Sphinx has the ability to generate table of contents, and > we could also improve the index over there, with the TOC/whatever that > it could generate. I don't think we should be duplicating this into the > README, but if that ship has sailed, this patch might still be useful. I don't agree with this change at all. This modern layout of the README was discussed at length. The "role" sections are very intentional. -Kees -- Kees Cook