Received: by 2002:a25:4158:0:0:0:0:0 with SMTP id o85csp552793yba; Wed, 24 Apr 2019 05:59:24 -0700 (PDT) X-Google-Smtp-Source: APXvYqwy4EOPGmYCSs7PY1RRzXsx4vEyMluCL8zwUAYmx4fD98WYjJ8QeN/Fw22tWY07UIXwfXqE X-Received: by 2002:a62:f24e:: with SMTP id y14mr33312680pfl.209.1556110763940; Wed, 24 Apr 2019 05:59:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1556110763; cv=none; d=google.com; s=arc-20160816; b=DX7UXL6eR8HoV1ygH38fEQv78RwwGK1s2jHLwuLWwEcQ8/0uMVl1a+X621MnnykXtK TWvpyi0t6OC/RnqwmLJldC2lshdTmAEHVjc/avQm8kHtGAX+tXiLxt3mBB72K1Vf16mP gVG7iONEO/lFrcS5kEOCEQ4vosEot1mgxW6l97Q4RlUyxsvvPvSAFONtRXX9y5A7WZ7V JwjsVEMXm044c8SyaK4ONIIiAXBWUwpQuiKwRofyzCZR9bHq24jhyCBe6JjfKblgk0OP f2q4KWPIT/M8iRptJCuSlc29fj+AxepPmOsBt8aUAsQnx9tB4p2RU3cKkf5Rx2bJIVQs 7nfg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:subject:cc:to:from:date :dkim-signature; bh=YQUnRZxjEBCnKH8zfJAZRfS63f1s0iUs9w+T9MeY1gk=; b=dgGVR2RVvoEl7CXzKFQVCW+7zuTKSz0vjuMKUQqoq297Chz4SvQwPOX+sU5gqKxIAe G10525i8r9JTOOCzxom5gk2MydXbUEf7SUxk5fNLTT75ObSrVE4OhjxSSjC9O/jBa9oJ Zf25o4Nwth13pQB9wOLkz1/BRScwAaTLTNsr0EwtYXka98nWd+DMMspKNymeFfecD6PK Nn7iGyfPFzrXc+/KnSknlJhcGLebHekLatFWTBcTVSLxGJTBafnGlwxmfOVMWnmVj8RX f+oNjmY3tR6d8/wW4Iql43Hpu4v6406VAJBJwgyvr/WpPMGTHSD/PGS0uUhmPxZC5tYJ 3ynQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=CFjBP9KV; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id gb18si18155475plb.283.2019.04.24.05.59.08; Wed, 24 Apr 2019 05:59:23 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=CFjBP9KV; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730364AbfDXM6D (ORCPT + 99 others); Wed, 24 Apr 2019 08:58:03 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:53424 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726322AbfDXM6D (ORCPT ); Wed, 24 Apr 2019 08:58:03 -0400 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: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=YQUnRZxjEBCnKH8zfJAZRfS63f1s0iUs9w+T9MeY1gk=; b=CFjBP9KV1A49YynjXl4/1LA0V lJpGvP/g7dgOC7LPAcndP0aGjqT4sPeJasASUF87IJ5vCIWF/UxH63xdjI7TUAG9ShHcTng3v2Efy KmcbFUxRZ+Po7jl1pSXGlikOUAM/tjsbuP6S9o/gVT2+fKEQ3w009J+7v1iJaqk9rccIM8AhlUbHK 4Cj/7klRS9ovGZOT7ioE8kew22vAcl+DeD58qokmpMvyWUhqGogeaFdgjuagtPh+oVWPL4X09mZpD SDJUb1pnEY6c1rrrTF/4yEecGStkL7n2cPXoSw9YLmelO7StEr48Zrj3Oexje2NV2xfV6d30Xv2XE X8DyLD31g==; Received: from 177.17.136.231.dynamic.adsl.gvt.net.br ([177.17.136.231] helo=coco.lan) by bombadil.infradead.org with esmtpsa (Exim 4.90_1 #2 (Red Hat Linux)) id 1hJHTM-0002cO-Pv; Wed, 24 Apr 2019 12:58:01 +0000 Date: Wed, 24 Apr 2019 09:57:56 -0300 From: Mauro Carvalho Chehab To: Mike Rapoport Cc: Jonathan Corbet , David Howells , Mike Snitzer , Peter Zijlstra , Linux Doc Mailing List , linux-kernel@vger.kernel.org, linux-arch@vger.kernel.org Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst Message-ID: <20190424095756.73b8981f@coco.lan> In-Reply-To: <20190424115126.GC6278@rapoport-lnx> References: <20190423132100.GB7132@redhat.com> <20190423083135.GA11158@hirez.programming.kicks-ass.net> <20190423125519.GA7104@redhat.com> <20190423130132.GT4038@hirez.programming.kicks-ass.net> <20704.1556031146@warthog.procyon.org.uk> <20190423105415.3a69a0cb@lwn.net> <20190423172641.612012c8@coco.lan> <20190424115126.GC6278@rapoport-lnx> X-Mailer: Claws Mail 3.17.3 (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-SRS-Rewrite: SMTP reverse-path rewritten from by bombadil.infradead.org. See http://www.infradead.org/rpr.html Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Wed, 24 Apr 2019 14:51:26 +0300 Mike Rapoport escreveu: > On Tue, Apr 23, 2019 at 05:26:41PM -0300, Mauro Carvalho Chehab wrote: > > Em Tue, 23 Apr 2019 10:54:15 -0600 > > Jonathan Corbet escreveu: > > > > > On Tue, 23 Apr 2019 15:52:26 +0100 > > > David Howells wrote: > > > > > > Suggestions / patches on how to improve things for *all* users of the > > > docs are certainly welcome! > > > > > > I am, incidentally, toying with the idea of trying to put together a > > > documentation microconf at the Linux Plumbers Conference this year. If > > > anybody out there thinks that's a good idea and would like to > > > participate, please let me know. > > > > If you add a microconf to LPC, I'm in. > > +1 > > > IMO, we made big advances with documentation, but there's a lot more > > to be done. Having a microconf to discuss those things may help us > > to bring new ideas about how to keep improving it. > > The most difficult part, IMHO, is to convince people to document things ;-) As David mentioned, maintainers could enforce merging new APIs only with documentation, with the risk of being unpopular. Well, maintainers are not among the most loved ones anyway ;-) My experience enforcing it at media subsystem is that it is not that hard to have developers writing documentation, once it becomes a rule, and the maintainers give the example. The big problem is how to deal with legacy stuff. I had to do that myself for the DVB subsystem, where the documentation were frozen back on 2002 days, while lots of new stuff got added (and, worse than that, with some very obscure ioctls that is used only by a single driver and some that were used only by OOT drivers). It take a few years to put it in sync with the code, but, once the ReST conversion was done, it became easier to do the work. Thanks, Mauro