Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1490277

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

Show all headers | View raw

Em Fri, 23 Sep 2016 09:15:01 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> 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?

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

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[RFC PATCH v3] docs-rst: user: add MAINTAINERS Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-23 17:10 +0200
  Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS Jonathan Corbet <corbet@lwn.net> - 2016-09-23 17:20 +0200
    Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-23 17:40 +0200
      Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS Markus Heiser <markus.heiser@darmarit.de> - 2016-09-23 18:30 +0200
  Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS Joe Perches <joe@perches.com> - 2016-09-23 18:30 +0200
    Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-23 20:00 +0200

csiph-web