Re: [RFC PATCH 00/11] docs: remove submitting-drivers.rst

From: Bagas Sanjaya
Date: Mon Jun 27 2022 - 22:50:34 EST


On 6/27/22 22:18, Lukas Bulwahn wrote:
> As future work---with this one submitting checklist gone---I see the harder
> follow-up task to synchronize and clean up the various submission hints/
> guidelines/checklists in the remaining kernel documentation that partly
> overlap and differ in detail, their structure (unstructured, unordered
> lists vs. sections and subsections) and their state of being outdated:
>
> Documentation/process/submit-checklist.rst
> Documentation/process/submitting-patches.rst
> MAINTAINERS#Tips for patch submitters
>
> My next task at hand is to read through all three documents, figure out
> what still applies and what is outdated, determine a good common structure
> for all three documents, include cross-links and make them to some extent
> follow a clear consistent policy. E.g., one document is a more detailed
> description of everything mentioned in the short list of another document.
> I will try to work through that in the next months or motivate and guide
> some colleague or mentee to work together with me on that.
>

Hi,

I think MAINTAINERS#Tips for patch submitters contains redundant info
compared to other submission guidelines, and some tips there are outdated
(like using `diff -u` instead of git). For consistency, that section can
be removed (in your next RFC series).

--
An old man doll... just what I always wanted! - Clara