MESSAGE
DATE | 2021-05-06 |
FROM | From: "Theodore Ts'o"
|
SUBJECT | Re: [Learn] Wikibook Linux kernel
|
From learn-bounces-at-nylxs.com Sat May 8 10:35:05 2021 Return-Path: X-Original-To: archive-at-mrbrklyn.com Delivered-To: archive-at-mrbrklyn.com Received: from www2.mrbrklyn.com (www2.mrbrklyn.com [96.57.23.82]) by mrbrklyn.com (Postfix) with ESMTP id 756CC163FD5; Sat, 8 May 2021 10:35:05 -0400 (EDT) X-Original-To: learn-at-www2.mrbrklyn.com Delivered-To: learn-at-www2.mrbrklyn.com Received: by mrbrklyn.com (Postfix, from userid 1000) id F1A38163FD5; Sat, 8 May 2021 10:28:17 -0400 (EDT) Resent-From: Ruben Safir Resent-Date: Sat, 8 May 2021 10:28:17 -0400 Resent-Message-ID: <20210508142817.GA5392-at-www2.mrbrklyn.com> Resent-To: hangout-at-mrbrklyn.com, learn-at-mrbrklyn.com X-Original-To: ruben-at-mrbrklyn.com Delivered-To: ruben-at-mrbrklyn.com Received: from shelob.surriel.com (shelob.surriel.com [96.67.55.147]) by mrbrklyn.com (Postfix) with ESMTP id 89102163FD0 for ; Sat, 8 May 2021 09:41:33 -0400 (EDT) Received: from localhost ([::1] helo=shelob.surriel.com) by shelob.surriel.com with esmtp (Exim 4.94.2) (envelope-from ) id 1lfNCz-00087Y-UZ; Sat, 08 May 2021 09:41:29 -0400 Received: from outgoing-auth-1.mit.edu ([18.9.28.11] helo=outgoing.mit.edu) by shelob.surriel.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94) (envelope-from ) id 1leeol-00027z-Vm for kernelnewbies-at-kernelnewbies.org; Thu, 06 May 2021 10:17:32 -0400 Received: from cwcc.thunk.org (pool-72-74-133-215.bstnma.fios.verizon.net [72.74.133.215]) (authenticated bits=0) (User authenticated as tytso-at-ATHENA.MIT.EDU) by outgoing.mit.edu (8.14.7/8.12.4) with ESMTP id 146EHGcb026652 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 6 May 2021 10:17:17 -0400 Received: by cwcc.thunk.org (Postfix, from userid 15806) id B22B415C39BD; Thu, 6 May 2021 10:17:16 -0400 (EDT) Date: Thu, 6 May 2021 10:17:16 -0400 From: "Theodore Ts'o" To: Constantine Shulyupin Message-ID: References: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-Mailman-Approved-At: Fri, 07 May 2021 17:09:44 -0400 Cc: erik-at-flodin.me, catalin.marinas-at-arm.com, linus.walleij-at-linaro.org, hch-at-lst.de, siyanteng-at-loongson.cn, mpe-at-ellerman.id.au, aaptel-at-suse.com, cw00.choi-at-samsung.com, stern-at-rowland.harvard.edu, shy828301-at-gmail.com, Guenter Roeck , kubernat-at-cesnet.cz, pmladek-at-suse.com, npiggin-at-gmail.com, mic-at-linux.microsoft.com, eric.auger-at-redhat.com, alex.williamson-at-redhat.com, jonas-at-protocubo.io, skhan-at-linuxfoundation.org, tglx-at-linutronix.de, sozeri-at-habana.ai, gregkh-at-linuxfoundation.org, jianyong.wu-at-arm.com, gi-oh.kim-at-ionos.com, hverkuil-cisco-at-xs4all.nl, gi-oh.kim-at-cloud.ionos.com, torvalds-at-linux-foundation.org, georgi.djakov-at-linaro.org, macro-at-orcam.me.uk, hengqi.chen-at-gmail.com, aquini-at-redhat.com, linux-doc-at-vger.kernel.org, yuchao0-at-huawei.com, stephane.blondon-at-gmail.com, James.Bottomley-at-hansenpartnership.com, kabel-at-kernel.org, unixbhaskar-at-gmail.com, kernelnewbies , bernard-at-vivo.com, rafael.j.wysocki-at-intel.com, jamorris-at-linux.microsoft.com, jgg-at-nvidia.com, mszeredi-at-redhat.com, wilken.gottwalt-at-posteo.net, chris.packham-at-alliedtelesis.co.nz, jaegeuk-at-kernel.org, aisheng.dong-at-nxp.com, niklas.soderlund+renesas-at-ragnatech.se, tom.zanussi-at-linux.intel.com, mathieu.poirier-at-linaro.org, Gustavo.Pimentel-at-synopsys.com, marcan-at-marcan.st, sean.j.christopherson-at-intel.com, jarkko-at-kernel.org, yangbo.lu-at-nxp.com, mkl-at-pengutronix.de, stfrench-at-microsoft.com, heikki.krogerus-at-linux.intel.com, brijesh.singh-at-amd.com, dlatypov-at-google.com, linux-at-rasmusvillemoes.dk, ast-at-kernel.org, sebastian.reichel-at-collabora.com, festevam-at-gmail.com, natet-at-google.com, daniel-at-iogearbox.net, Jonathan Corbet , masahiroy-at-kernel.org, haren-at-linux.ibm.com, willy-at-infradead.org, federico.vaga-at-vaga.pv.it, yuzenghui-at-huawei.com, keescook-at-chromium.org, Arnd Bergmann , schnelle-at-linux.ibm.com, andreyknvl-at-google.com, broonie-at-kernel.org, bp-at-alien8.de, i-at-zenithal.me, nicolas.dichtel-at-6wind.com, pcc-at-google.com, sumit.garg-at-linaro.org, sakari.ailus-at-linux.intel.com, davem-at-davemloft.net, sbhat-at-linux.ibm.com, peterz-at-infradead.org, linux-at-leemhuis.info, dhowells-at-redhat.com, tamar.mashiah-at-intel.com, yangtiezhu-at-loongson.cn, vincenzo.frascino-at-arm.com, dikshita-at-codeaurora.org, mchehab+huawei-at-kernel.org, maz-at-kernel.org, rppt-at-linux.ibm.com, vladyslavt-at-nvidia.com, kuba-at-kernel.org, eesposit-at-redhat.com, stanimir.varbanov-at-linaro.org, anshuman.khandual-at-arm.com, hca-at-linux.ibm.com, bobwxc-at-email.cn, hdegoede-at-redhat.com, parav-at-nvidia.com, davidgow-at-google.com, Jonathan.Cameron-at-huawei.com, alexandru.elisei-at-arm.com, vbabka-at-suse.cz, axboe-at-kernel.dk, srutherford-at-google.com, luzmaximilian-at-gmail.com, ogabbay-at-kernel.org, vkoul-at-kernel.org, erik.rosen-at-metormote.com, pbonzini-at-redhat.com, saeedm-at-nvidia.com X-BeenThere: kernelnewbies-at-kernelnewbies.org X-Mailman-Version: 2.1.15 Precedence: list X-Mailman-Approved-At: Sat, 08 May 2021 10:35:03 -0400 Subject: Re: [Learn] Wikibook Linux kernel X-BeenThere: learn-at-nylxs.com List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: learn-bounces-at-nylxs.com Sender: "Learn"
On Thu, May 06, 2021 at 01:58:35PM +0300, Constantine Shulyupin wrote: > Dear Linux kernel documentation writers and readers: > > Writing Linux documentation is a huge complex collaborative process. > To make it better I invite you to contribute to > https://en.wikibooks.org/wiki/The_Linux_Kernel
There are some wiki's that are available at *.wiki.kernel.org. For example, ext4.wiki.kernel.org. We've largely abandoned it, in favor of using Documentation in the kernel sources, because if you leave it "updated by anyone", unless you have people constantly watching for spam or trash updates which have to be reverted, it quickly becomes a mess. Or you can keep tight control over who you give accounts to, but then it doesn't get updated all that often.
Keeping the documentation in sync with the kernel sources means it's much more likely for the documentation to be updated when the kernel is updated, and so for example we've migrated:
https://ext4.wiki.kernel.org/index.php/Ext4_Disk_Layout
to:
https://www.kernel.org/doc/html/latest/filesystems/ext4/index.html
with the sources available at:
https://git.kernel.org/pub/scm/linux/kernel/git/tytso/ext4.git/tree/Documentation/filesystems/ext4
... and been much happier with the result.
Cheers,
- Ted
_______________________________________________ Kernelnewbies mailing list Kernelnewbies-at-kernelnewbies.org https://lists.kernelnewbies.org/mailman/listinfo/kernelnewbies _______________________________________________ Learn mailing list Learn-at-nylxs.com http://lists.mrbrklyn.com/mailman/listinfo/learn
|
|