From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org [172.17.192.35]) by mail.linuxfoundation.org (Postfix) with ESMTPS id D5D1C49D for ; Sat, 24 Jun 2017 12:10:40 +0000 (UTC) Received: from cloudserver094114.home.net.pl (cloudserver094114.home.net.pl [79.96.170.134]) by smtp1.linuxfoundation.org (Postfix) with ESMTPS id C960DE5 for ; Sat, 24 Jun 2017 12:10:38 +0000 (UTC) From: "Rafael J. Wysocki" To: Jonathan Corbet Date: Sat, 24 Jun 2017 14:03:15 +0200 Message-ID: <39451731.v6W3Bd9s34@aspire.rjw.lan> In-Reply-To: <8342944.hYkokseh5H@aspire.rjw.lan> References: <20170623123936.42dab05f@lwn.net> <8342944.hYkokseh5H@aspire.rjw.lan> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Cc: ksummit-discuss@lists.linuxfoundation.org Subject: Re: [Ksummit-discuss] [MAINTAINERS SUMMIT] Documentation issues List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Saturday, June 24, 2017 01:09:28 AM Rafael J. Wysocki wrote: > On Friday, June 23, 2017 12:39:36 PM Jonathan Corbet wrote: > > The docs pull for 4.13 will include the conversion of the last DocBook > > template files, thanks mostly to Mauro. That's the good news; the bad > > news is that I get to explain a lot of merge conflicts to Linus, most of > > which result from other trees reaching into Documentation/ and changing > > files that have been converted. > > > > I can continue in this mode, but I do wonder if there's a better way out > > there somewhere. So I think there would be value in a session on the > > maintenance of "subsystems" that don't fit neatly into the kernel > > source-tree hierarchy. > > > > We could also talk about the state of the RST conversion and whether/how > > we'd like it to continue. Perhaps we would rather, as Peter recently > > suggested, "just delete all that nonsense and go back to 80 column 7bit > > ASCII"? In general, what do the maintainers want from the documentation > > subsystem, and how can we make it easy to continue improving our docs? > > For one, I'm going to continue converting PM documentation to RST and I would > not welcome deleting the existing .txt one until that is complete. > > Same goes for ACPI, pretty much. > > Also I don't expect too many documentation-related merge conflicts in the PM > case going forward. I should probably add that I find RST much more appealing than "80 column 7bit ASCII" at least because of how it allows cross-references to be expressed if nothing else. Thanks, Rafael