From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S966781AbcIWPfa (ORCPT ); Fri, 23 Sep 2016 11:35:30 -0400 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:43178 "EHLO s-opensource.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S965311AbcIWPfO (ORCPT ); Fri, 23 Sep 2016 11:35:14 -0400 Date: Fri, 23 Sep 2016 12:35:08 -0300 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Mauro Carvalho Chehab , Linux Kernel Mailing List Subject: Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS Message-ID: <20160923123508.59e243b9@vento.lan> In-Reply-To: <20160923091501.38cc6a0b@lwn.net> References: <20160923120733.546a4b7a@vento.lan> <20160923091501.38cc6a0b@lwn.net> Organization: Samsung X-Mailer: Claws Mail 3.13.2 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Fri, 23 Sep 2016 09:15:01 -0600 Jonathan Corbet escreveu: > On Fri, 23 Sep 2016 12:07:33 -0300 > Mauro Carvalho Chehab wrote: > > > including MAINTAINERS using ReST is tricky, because all > > maintainer's entries are like: > > So I'm generally in favor of moving things over to RST, but I have to ask: > what's the payoff for doing that with the MAINTAINERS file? I *suppose* > it's documentation, but it's also really a flat-file database of > who-to-email information. I'm not sure I see the value of including it in > the docs? What am I missing here? It is part of the REPORTING-BUGS procedure to check MAINTAINERS and find to what ML the bug should be reported: https://mchehab.fedorapeople.org/user/REPORTING-BUGS.html#how-to-report-linux-kernel-bugs I _suspect_ that the vast majority of Linux users don't read the MAINTAINERS file, but, instead, just google at the net for an answer to their troubles. By having it on an html file, together with other user's documentation, the payoff is that more people should do the right thing when seeking for bug resolutions at the right mailing lists or when reporting bugs, ultimately helping to improve the Kernel quality. Regards, Mauro