From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Subject: Re: [PATCH 00/44] Manually convert filesystem FS documents to ReST Date: Wed, 19 Feb 2020 16:11:13 +0100 Message-ID: <20200219161113.41add6e4@kernel.org> References: <20200218040146.GM7778@bombadil.infradead.org> <20200218110406.098fdc09@kernel.org> <20200219023234.7b704acb@lwn.net> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <20200219023234.7b704acb@lwn.net> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-mtd" Errors-To: linux-mtd-bounces+gldm-linux-mtd-36=m.gmane-mx.org@lists.infradead.org To: Jonathan Corbet Cc: Latchesar Ionkov , Martin Brandenburg , Jan Kara , Linux Doc Mailing List , Dominique Martinet , Amir Goldstein , Bob Copeland , David Howells , Chris Mason , linux-mtd@lists.infradead.org, Ilya Dryomov , linux-afs@lists.infradead.org, Mike Marshall , Naohiro Aota , Christoph Hellwig , linux-nilfs@vger.kernel.org, Andreas Gruenbacher , Sage Weil , Richard Weinberger , Matthew Wilcox , Tyler Hicks , cluster-devel@redhat.com, v9fs-developer@lists.sourceforge.net, Gao Xiang , linux-ext4@vger.kernel.org, Salah List-Id: ceph-devel.vger.kernel.org Em Wed, 19 Feb 2020 02:32:34 -0700 Jonathan Corbet escreveu: > On Tue, 18 Feb 2020 11:04:06 +0100 > Mauro Carvalho Chehab wrote: > > > Then, do a second pass at files outside the new directories (like > > admin-guide), in order to better organize things, eventually splitting > > some files into kAPI, uAPI and/or admin-guide. > > I'm looking forward to this phase! Yes it is harder, and it often > requires selling the idea to skeptical maintainers. But that is how, > IMO, we get from where we're at now to something closer to a set of > coherent kernel docs. Yeah, fully agreed that this is an important step. I'm even more anxious for a third phase: filling the gaps. I'm pretty sure that several important parts of the Kernel aren't properly represented at Documentation. Yet, before start writing new things, we should first organizing what we already have, making them well-organized. Cheers, Mauro ______________________________________________________ Linux MTD discussion mailing list http://lists.infradead.org/mailman/listinfo/linux-mtd/ From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Date: Wed, 19 Feb 2020 16:11:13 +0100 Subject: [Ocfs2-devel] [PATCH 00/44] Manually convert filesystem FS documents to ReST In-Reply-To: <20200219023234.7b704acb@lwn.net> References: <20200218040146.GM7778@bombadil.infradead.org> <20200218110406.098fdc09@kernel.org> <20200219023234.7b704acb@lwn.net> Message-ID: <20200219161113.41add6e4@kernel.org> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: Jonathan Corbet Cc: Latchesar Ionkov , Martin Brandenburg , Jan Kara , Linux Doc Mailing List , Dominique Martinet , Amir Goldstein , Bob Copeland , David Howells , Chris Mason , linux-mtd@lists.infradead.org, Ilya Dryomov , linux-afs@lists.infradead.org, Mike Marshall , Naohiro Aota , Christoph Hellwig , linux-nilfs@vger.kernel.org, Andreas Gruenbacher , Sage Weil , Richard Weinberger , Matthew Wilcox , Tyler Hicks , cluster-devel@redhat.com, v9fs-developer@lists.sourceforge.net, Gao Xiang , linux-ext4@vger.kernel.org, Salah Em Wed, 19 Feb 2020 02:32:34 -0700 Jonathan Corbet escreveu: > On Tue, 18 Feb 2020 11:04:06 +0100 > Mauro Carvalho Chehab wrote: > > > Then, do a second pass at files outside the new directories (like > > admin-guide), in order to better organize things, eventually splitting > > some files into kAPI, uAPI and/or admin-guide. > > I'm looking forward to this phase! Yes it is harder, and it often > requires selling the idea to skeptical maintainers. But that is how, > IMO, we get from where we're at now to something closer to a set of > coherent kernel docs. Yeah, fully agreed that this is an important step. I'm even more anxious for a third phase: filling the gaps. I'm pretty sure that several important parts of the Kernel aren't properly represented at Documentation. Yet, before start writing new things, we should first organizing what we already have, making them well-organized. Cheers, Mauro From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.3 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_2 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 51CA9C34047 for ; Wed, 19 Feb 2020 15:11:57 +0000 (UTC) Received: from lists.sourceforge.net (lists.sourceforge.net [216.105.38.7]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 20A6924670 for ; Wed, 19 Feb 2020 15:11:57 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=sourceforge.net header.i=@sourceforge.net header.b="jDbcu9au"; dkim=fail reason="signature verification failed" (1024-bit key) header.d=sf.net header.i=@sf.net header.b="V5RsBMxT"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="j2lHtYJz" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 20A6924670 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=linux-f2fs-devel-bounces@lists.sourceforge.net Received: from [127.0.0.1] (helo=sfs-ml-4.v29.lw.sourceforge.com) by sfs-ml-4.v29.lw.sourceforge.com with esmtp (Exim 4.90_1) (envelope-from ) id 1j4R12-0003XY-Nt; Wed, 19 Feb 2020 15:11:56 +0000 Received: from [172.30.20.202] (helo=mx.sourceforge.net) by sfs-ml-4.v29.lw.sourceforge.com with esmtps (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.90_1) (envelope-from ) id 1j4R10-0003X6-E5; Wed, 19 Feb 2020 15:11:54 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=sourceforge.net; s=x; h=Content-Transfer-Encoding:Content-Type:MIME-Version :References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=Uvk/WRH89AWMdOVPSMRB0SCJsQtjKOS/wrWpFHrNMmM=; b=jDbcu9auHiUD2Z/wWSZCV8UIJf Q0KXnVpXS1QyqUkLLCua9UZ0wGS1DtoRXtFvu8cAZsM6eQ2JAm4xcMu5zQix28/yI99OXH5HMGx6i gva03TKvyvNXqHLQpYQCBa9szZ+CNEW1o7nBFqnA1I5jiS6tJzgQ9okq2ERehAriAKBs=; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=sf.net; s=x ; h=Content-Transfer-Encoding:Content-Type:MIME-Version:References: In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=Uvk/WRH89AWMdOVPSMRB0SCJsQtjKOS/wrWpFHrNMmM=; b=V5RsBMxT4KVFZVFJX48/go8K6y tHJIe4bQGN9F3HGkkZCM/RaRFtu1YJFq/7sdd8nBhMPejooLSDWQQ0C1fFT6Zo4fjIdBUMcYjiyb1 BR6IF6+aDKj/SCRPO4jRaGSban2AptyAWqnrtq95TpzNHNmC/Gxg3VRbXATLou4+WlfM=; Received: from bombadil.infradead.org ([198.137.202.133]) by sfi-mx-1.v28.lw.sourceforge.com with esmtps (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.92.2) id 1j4R0y-0001k6-Js; Wed, 19 Feb 2020 15:11:54 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To: From:Date:Sender:Reply-To:Content-ID:Content-Description; bh=Uvk/WRH89AWMdOVPSMRB0SCJsQtjKOS/wrWpFHrNMmM=; b=j2lHtYJz/WtcOazwhe9FYpwcMw PilYDNbrwf0g6lTRRzQa0QrB8HYHq4emi91b2LPURX5BgK7AAbxvYBLaMzwrtvNwImG/Fe2WBhENT w8oYGUiDuQf2Y82cs6KthEC4N0cGjMFvIJAk4el1ecH1mDO7oFTBYBHPrpOVoJsBiVYOKlrN2kKul jQ+c46w/yklPdM3nTe4K6vkbqBn0SiKUJhg0HquiKuRPfo0HM7Lr7fZNwQXZL0MIsJvqc+OP48inL 1yZzyFDMvMB/XYuYLRKDH8PYvPOr4nLtGpKWOIh6aa0/SJvmYFsuI5VmNJkbOVZjHKZow7nLGP4Vl BXjkRYUA==; Received: from tmo-109-126.customers.d1-online.com ([80.187.109.126] helo=localhost) by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1j4R0Y-0000UF-OT; Wed, 19 Feb 2020 15:11:26 +0000 Date: Wed, 19 Feb 2020 16:11:13 +0100 From: Mauro Carvalho Chehab To: Jonathan Corbet Message-ID: <20200219161113.41add6e4@kernel.org> In-Reply-To: <20200219023234.7b704acb@lwn.net> References: <20200218040146.GM7778@bombadil.infradead.org> <20200218110406.098fdc09@kernel.org> <20200219023234.7b704acb@lwn.net> X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 X-Headers-End: 1j4R0y-0001k6-Js Subject: Re: [f2fs-dev] [PATCH 00/44] Manually convert filesystem FS documents to ReST X-BeenThere: linux-f2fs-devel@lists.sourceforge.net X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Latchesar Ionkov , Martin Brandenburg , Jan Kara , Linux Doc Mailing List , Dominique Martinet , Amir Goldstein , Bob Copeland , David Howells , Chris Mason , linux-mtd@lists.infradead.org, Ilya Dryomov , linux-afs@lists.infradead.org, Mike Marshall , Naohiro Aota , Christoph Hellwig , linux-nilfs@vger.kernel.org, Andreas Gruenbacher , Sage Weil , Richard Weinberger , Matthew Wilcox , Tyler Hicks , cluster-devel@redhat.com, v9fs-developer@lists.sourceforge.net, Gao Xiang , linux-ext4@vger.kernel.org, Salah Triki , Alexey Dobriyan , devel@lists.orangefs.org, Eric Van Hensbergen , ecryptfs@vger.kernel.org, Josef Bacik , Bob Peterson , "Tigran A. Aivazian" , David Sterba , Jaegeuk Kim , ceph-devel@vger.kernel.org, Ryusuke Konishi , Anton Altaparmakov , Damien Le Moal , Luis de Bethencourt , Nicolas Pitre , linux-ntfs-dev@lists.sourceforge.net, Jeff Layton , linux-f2fs-devel@lists.sourceforge.net, ocfs2-devel@oss.oracle.com, Jan Kara , linux-fsdevel@vger.kernel.org, Phillip Lougher , Johannes Thumshirn , linux-erofs@lists.ozlabs.org, linux-karma-devel@lists.sourceforge.net, linux-btrfs@vger.kernel.org Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: linux-f2fs-devel-bounces@lists.sourceforge.net Em Wed, 19 Feb 2020 02:32:34 -0700 Jonathan Corbet escreveu: > On Tue, 18 Feb 2020 11:04:06 +0100 > Mauro Carvalho Chehab wrote: > > > Then, do a second pass at files outside the new directories (like > > admin-guide), in order to better organize things, eventually splitting > > some files into kAPI, uAPI and/or admin-guide. > > I'm looking forward to this phase! Yes it is harder, and it often > requires selling the idea to skeptical maintainers. But that is how, > IMO, we get from where we're at now to something closer to a set of > coherent kernel docs. Yeah, fully agreed that this is an important step. I'm even more anxious for a third phase: filling the gaps. I'm pretty sure that several important parts of the Kernel aren't properly represented at Documentation. Yet, before start writing new things, we should first organizing what we already have, making them well-organized. Cheers, Mauro _______________________________________________ Linux-f2fs-devel mailing list Linux-f2fs-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.5 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_SANE_2 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8F6C4C34047 for ; Wed, 19 Feb 2020 15:11:46 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 61B4F24670 for ; Wed, 19 Feb 2020 15:11:46 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="hVSGF5eu" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 61B4F24670 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-mtd-bounces+linux-mtd=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Subject:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=B7EHMyUPv2q6yIop752l20HueDe0JniJezXOAylvmSI=; b=hVSGF5eu4UwZ8T uvRCB/yRCEcP2FGbR8RxZ4oIS1HOUQLZBI1gBxXM3W+mcbpbg2mEEMDXysqHyLtFTW8r+WgxaLO5W 71SmOheDxJUfiXhs/COJk8sRnDI9PNnUUTcjRJ4M/iv61snypCoKlAi5SgnEzmx/yvsrgQftKMl5k Fz9U+s76AeJKbby71mNB9ofLucgjRZCgV7gby/vOecn7LfAivvItIfO2NPHt7rio9wVUlH9fOIvVC g9nJ83kGqirZRyLBrATzoZI3+vdEJILpB3FH3IvL3nFuF9cPw2NWfe3qz6JxW8k64wKAKAh0G4PlS e6aB/0ifMALFnuE1SJbg==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1j4R0e-0000Xm-HX; Wed, 19 Feb 2020 15:11:32 +0000 Received: from tmo-109-126.customers.d1-online.com ([80.187.109.126] helo=localhost) by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1j4R0Y-0000UF-OT; Wed, 19 Feb 2020 15:11:26 +0000 Date: Wed, 19 Feb 2020 16:11:13 +0100 From: Mauro Carvalho Chehab To: Jonathan Corbet Subject: Re: [PATCH 00/44] Manually convert filesystem FS documents to ReST Message-ID: <20200219161113.41add6e4@kernel.org> In-Reply-To: <20200219023234.7b704acb@lwn.net> References: <20200218040146.GM7778@bombadil.infradead.org> <20200218110406.098fdc09@kernel.org> <20200219023234.7b704acb@lwn.net> X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 X-BeenThere: linux-mtd@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux MTD discussion mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Latchesar Ionkov , Martin Brandenburg , Jan Kara , Linux Doc Mailing List , Dominique Martinet , Amir Goldstein , Bob Copeland , David Howells , Chris Mason , linux-mtd@lists.infradead.org, Ilya Dryomov , linux-afs@lists.infradead.org, Mike Marshall , Naohiro Aota , Christoph Hellwig , linux-nilfs@vger.kernel.org, Andreas Gruenbacher , Sage Weil , Richard Weinberger , Matthew Wilcox , Tyler Hicks , cluster-devel@redhat.com, v9fs-developer@lists.sourceforge.net, Gao Xiang , linux-ext4@vger.kernel.org, Salah Triki , Alexey Dobriyan , devel@lists.orangefs.org, Chao Yu , Eric Van Hensbergen , ecryptfs@vger.kernel.org, Josef Bacik , Bob Peterson , "Tigran A. Aivazian" , David Sterba , Jaegeuk Kim , ceph-devel@vger.kernel.org, Ryusuke Konishi , Anton Altaparmakov , Damien Le Moal , Luis de Bethencourt , Nicolas Pitre , linux-ntfs-dev@lists.sourceforge.net, Jeff Layton , linux-f2fs-devel@lists.sourceforge.net, ocfs2-devel@oss.oracle.com, Jan Kara , linux-fsdevel@vger.kernel.org, Phillip Lougher , Johannes Thumshirn , linux-erofs@lists.ozlabs.org, linux-karma-devel@lists.sourceforge.net, linux-btrfs@vger.kernel.org Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-mtd" Errors-To: linux-mtd-bounces+linux-mtd=archiver.kernel.org@lists.infradead.org Em Wed, 19 Feb 2020 02:32:34 -0700 Jonathan Corbet escreveu: > On Tue, 18 Feb 2020 11:04:06 +0100 > Mauro Carvalho Chehab wrote: > > > Then, do a second pass at files outside the new directories (like > > admin-guide), in order to better organize things, eventually splitting > > some files into kAPI, uAPI and/or admin-guide. > > I'm looking forward to this phase! Yes it is harder, and it often > requires selling the idea to skeptical maintainers. But that is how, > IMO, we get from where we're at now to something closer to a set of > coherent kernel docs. Yeah, fully agreed that this is an important step. I'm even more anxious for a third phase: filling the gaps. I'm pretty sure that several important parts of the Kernel aren't properly represented at Documentation. Yet, before start writing new things, we should first organizing what we already have, making them well-organized. Cheers, Mauro ______________________________________________________ Linux MTD discussion mailing list http://lists.infradead.org/mailman/listinfo/linux-mtd/ From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.3 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_2 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 31B86C34050 for ; Wed, 19 Feb 2020 15:13:58 +0000 (UTC) Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 9C83424670 for ; Wed, 19 Feb 2020 15:13:57 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="j2lHtYJz" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 9C83424670 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=linux-erofs-bounces+linux-erofs=archiver.kernel.org@lists.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 48N1TH6d04zDqZL for ; Thu, 20 Feb 2020 02:13:55 +1100 (AEDT) Authentication-Results: lists.ozlabs.org; spf=permerror (SPF Permanent Error: Void lookup limit of 2 exceeded) smtp.mailfrom=kernel.org (client-ip=2607:7c80:54:e::133; helo=bombadil.infradead.org; envelope-from=mchehab+huawei@kernel.org; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: lists.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=infradead.org header.i=@infradead.org header.a=rsa-sha256 header.s=bombadil.20170209 header.b=j2lHtYJz; dkim-atps=neutral Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:e::133]) (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 lists.ozlabs.org (Postfix) with ESMTPS id 48N1RL4fwBzDqb5 for ; Thu, 20 Feb 2020 02:12:13 +1100 (AEDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To: From:Date:Sender:Reply-To:Content-ID:Content-Description; bh=Uvk/WRH89AWMdOVPSMRB0SCJsQtjKOS/wrWpFHrNMmM=; b=j2lHtYJz/WtcOazwhe9FYpwcMw PilYDNbrwf0g6lTRRzQa0QrB8HYHq4emi91b2LPURX5BgK7AAbxvYBLaMzwrtvNwImG/Fe2WBhENT w8oYGUiDuQf2Y82cs6KthEC4N0cGjMFvIJAk4el1ecH1mDO7oFTBYBHPrpOVoJsBiVYOKlrN2kKul jQ+c46w/yklPdM3nTe4K6vkbqBn0SiKUJhg0HquiKuRPfo0HM7Lr7fZNwQXZL0MIsJvqc+OP48inL 1yZzyFDMvMB/XYuYLRKDH8PYvPOr4nLtGpKWOIh6aa0/SJvmYFsuI5VmNJkbOVZjHKZow7nLGP4Vl BXjkRYUA==; Received: from tmo-109-126.customers.d1-online.com ([80.187.109.126] helo=localhost) by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1j4R0Y-0000UF-OT; Wed, 19 Feb 2020 15:11:26 +0000 Date: Wed, 19 Feb 2020 16:11:13 +0100 From: Mauro Carvalho Chehab To: Jonathan Corbet Subject: Re: [PATCH 00/44] Manually convert filesystem FS documents to ReST Message-ID: <20200219161113.41add6e4@kernel.org> In-Reply-To: <20200219023234.7b704acb@lwn.net> References: <20200218040146.GM7778@bombadil.infradead.org> <20200218110406.098fdc09@kernel.org> <20200219023234.7b704acb@lwn.net> X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: linux-erofs@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development of Linux EROFS file system List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Latchesar Ionkov , Martin Brandenburg , Jan Kara , Linux Doc Mailing List , Dominique Martinet , Amir Goldstein , Bob Copeland , David Howells , Chris Mason , linux-mtd@lists.infradead.org, Ilya Dryomov , linux-afs@lists.infradead.org, Mike Marshall , Naohiro Aota , Christoph Hellwig , linux-nilfs@vger.kernel.org, Andreas Gruenbacher , Sage Weil , Richard Weinberger , Matthew Wilcox , Tyler Hicks , cluster-devel@redhat.com, v9fs-developer@lists.sourceforge.net, Gao Xiang , linux-ext4@vger.kernel.org, Salah Triki , Alexey Dobriyan , devel@lists.orangefs.org, Eric Van Hensbergen , ecryptfs@vger.kernel.org, Josef Bacik , Bob Peterson , "Tigran A. Aivazian" , David Sterba , Jaegeuk Kim , ceph-devel@vger.kernel.org, Ryusuke Konishi , Anton Altaparmakov , Damien Le Moal , Luis de Bethencourt , Nicolas Pitre , linux-ntfs-dev@lists.sourceforge.net, Jeff Layton , linux-f2fs-devel@lists.sourceforge.net, ocfs2-devel@oss.oracle.com, Jan Kara , linux-fsdevel@vger.kernel.org, Phillip Lougher , Johannes Thumshirn , linux-erofs@lists.ozlabs.org, linux-karma-devel@lists.sourceforge.net, linux-btrfs@vger.kernel.org Errors-To: linux-erofs-bounces+linux-erofs=archiver.kernel.org@lists.ozlabs.org Sender: "Linux-erofs" Em Wed, 19 Feb 2020 02:32:34 -0700 Jonathan Corbet escreveu: > On Tue, 18 Feb 2020 11:04:06 +0100 > Mauro Carvalho Chehab wrote: > > > Then, do a second pass at files outside the new directories (like > > admin-guide), in order to better organize things, eventually splitting > > some files into kAPI, uAPI and/or admin-guide. > > I'm looking forward to this phase! Yes it is harder, and it often > requires selling the idea to skeptical maintainers. But that is how, > IMO, we get from where we're at now to something closer to a set of > coherent kernel docs. Yeah, fully agreed that this is an important step. I'm even more anxious for a third phase: filling the gaps. I'm pretty sure that several important parts of the Kernel aren't properly represented at Documentation. Yet, before start writing new things, we should first organizing what we already have, making them well-organized. Cheers, Mauro From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Date: Wed, 19 Feb 2020 16:11:13 +0100 Subject: [Cluster-devel] [PATCH 00/44] Manually convert filesystem FS documents to ReST In-Reply-To: <20200219023234.7b704acb@lwn.net> References: <20200218040146.GM7778@bombadil.infradead.org> <20200218110406.098fdc09@kernel.org> <20200219023234.7b704acb@lwn.net> Message-ID: <20200219161113.41add6e4@kernel.org> List-Id: To: cluster-devel.redhat.com MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Em Wed, 19 Feb 2020 02:32:34 -0700 Jonathan Corbet escreveu: > On Tue, 18 Feb 2020 11:04:06 +0100 > Mauro Carvalho Chehab wrote: > > > Then, do a second pass at files outside the new directories (like > > admin-guide), in order to better organize things, eventually splitting > > some files into kAPI, uAPI and/or admin-guide. > > I'm looking forward to this phase! Yes it is harder, and it often > requires selling the idea to skeptical maintainers. But that is how, > IMO, we get from where we're at now to something closer to a set of > coherent kernel docs. Yeah, fully agreed that this is an important step. I'm even more anxious for a third phase: filling the gaps. I'm pretty sure that several important parts of the Kernel aren't properly represented at Documentation. Yet, before start writing new things, we should first organizing what we already have, making them well-organized. Cheers, Mauro