Re: [PATCH v2 10/11] MAINTAINERS: make clearer about what's expected for "P" field

[Mauro Carvalho Chehab <mchehab+huawei@kernel.org>]

On Tue, 5 May 2026 20:02:03 +0200
Miguel Ojeda <miguel.ojeda.sandonis@gmail.com> wrote:

> On Tue, May 5, 2026 at 3:32 PM Mauro Carvalho Chehab
> <mchehab+huawei@kernel.org> wrote:
> >
> > extenal site. Make it clearer.  
> 
> Typo.
> 
> > +          patches to the given subsystem. This is either an in-tree .rst file,  
> 
> Should this mention that the file should be within `Doc/`, due to the
> requirement of the current system?

Makes sense, I'll add the corresponding text there.

> 
> By the way, are we keeping the parser change to avoid breakage in case
> someone does not follow this? Or should this be
> 
>     ideally, an in-tree .rst file within Documentation/ for best rendering
> 
> or similar?

The parser won't break if P: violates the .rst rule. Yet, doing
something about that seems to be the right thing to do. Perhaps
the best would be to output a warning instead.

> 
> (Also, if the parser is changed, then I am ambivalent about changing
> the `P:` to GitHub, since the local file is available by definition,
> but GitHub may not... But it is fine either way!)
> 
> Thanks!
> 
> Cheers,
> Miguel



Thanks,
Mauro