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