On Fri, 2016-09-23 at 12:07 -0300, Mauro Carvalho Chehab wrote: > So, let's use an unusual approach: manually convert the > text at the MAINTAINERS file head, adding it at a new > Documentation/user/MAINTAINERS.rst, and include, as a code > block, the rest of MAINTAINERS contents, with only the > contents of the maintainers entries. > > There's a side effect of this approach: now, if the > explanation text at the MAINTAINERS file is touched, it should be > modified also at the Documentation/user/MAINTAINERS.rst file. > Yet, as the number of changes there are small, this > should be manageable. couldn't this be a generated file from some awk script instead of being duplicated content with a plea to be kept in sync? > diff --git a/Documentation/user/MAINTAINERS.rst b/Documentation/user/MAINTAINERS.rst > new file mode 100644 [etc] -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html