From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
        id S966354AbcIWPPH (ORCPT <rfc822;w@1wt.eu>);
        Fri, 23 Sep 2016 11:15:07 -0400
Received: from tex.lwn.net ([70.33.254.29]:57205 "EHLO vena.lwn.net"
        rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP
        id S965332AbcIWPPD (ORCPT <rfc822;linux-kernel@vger.kernel.org>);
        Fri, 23 Sep 2016 11:15:03 -0400
Date: Fri, 23 Sep 2016 09:15:01 -0600
From: Jonathan Corbet <corbet@lwn.net>
To: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
        Mauro Carvalho Chehab <mchehab@infradead.org>,
        Mauro Carvalho Chehab <mchehab@kernel.org>,
        Linux Kernel Mailing List <linux-kernel@vger.kernel.org>
Subject: Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS
Message-ID: <20160923091501.38cc6a0b@lwn.net>
In-Reply-To: <20160923120733.546a4b7a@vento.lan>
References: <20160923120733.546a4b7a@vento.lan>
Organization: LWN.net
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 8bit
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Fri, 23 Sep 2016 12:07:33 -0300
Mauro Carvalho Chehab <mchehab@s-opensource.com> 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?

Thanks,

jon