Re: [Ksummit-discuss] [MAINTAINERS SUMMIT] Documentation issues

[Mark Brown <broonie@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 1072 bytes --]

On Tue, Jun 27, 2017 at 10:38:54AM +0200, Daniel Vetter wrote:

> Looking at MAINTAINERS, there's relatively few entries for files under
> Documentation/, and most are for individual files (about 450). None
> are for one of the remaining DocBook files still in 4.12 afaics. I
> think we can fix this problem by making sure that a) docs are sorted
> usefully into directories (e.g. we put all the gpu stuff into
> Documentation/gpu/) and b) there's MAINTAINERS entries for all of them
> (which atm doesn't seem to be the case for a lot of stuff).

Yeah, there's directories there for my subsystems but I have to confess
I'd not checked the broader picture recently.

> But I think the lack of clear maintainer responsibilities for docs was
> something Jon already brough up at the previous KS, and we didn't
> really get anywhere with it.

Is that a case of people actively getting in the way somehow or more a
case that we're not able to generate enough interest for people to
actually work on improving the docs (which is partly about us showing
that we care of course)?

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]