Em Wed, 18 Sep 2019 11:07:16 -0300 André Almeida <andrealmeid@xxxxxxxxxxxxx> escreveu: > Hello Mauro, > > On 9/18/19 10:59 AM, Mauro Carvalho Chehab wrote: > > Document the basic policies of the media subsystem profile. > > > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx> > > --- > > Documentation/media/index.rst | 1 + > > .../media/maintainer-entry-profile.rst | 157 ++++++++++++++++++ > > MAINTAINERS | 1 + > > 3 files changed, 159 insertions(+) > > create mode 100644 Documentation/media/maintainer-entry-profile.rst > > > > diff --git a/Documentation/media/index.rst b/Documentation/media/index.rst > > index 0301c25ff887..ac94685b822a 100644 > > --- a/Documentation/media/index.rst > > +++ b/Documentation/media/index.rst > > @@ -12,6 +12,7 @@ Linux Media Subsystem Documentation > > .. toctree:: > > :maxdepth: 2 > > > > + maintainer-entry-profile > > media_uapi > > media_kapi > > dvb-drivers/index > > diff --git a/Documentation/media/maintainer-entry-profile.rst b/Documentation/media/maintainer-entry-profile.rst > > new file mode 100644 > > index 000000000000..68d642abe2c1 > > --- /dev/null > > +++ b/Documentation/media/maintainer-entry-profile.rst > > @@ -0,0 +1,157 @@ > > +Media Subsystem Profile > > +======================= > > + > > +Overview > > +-------- > > + > > +The media subsystem covers support for a variety of devices: stream > > +capture, analog and digital TV, cameras, remote controllers, HDMI CEC > > +and media pipeline control. > > + > > +It covers, mainly, the contents of those directories: > > + > > + - drivers/media > > + - drivers/staging/media > > + - Documentation/media > > + - include/media > > + > > +Both media userspace and Kernel APIs are documented and should be kept in > > +sync with the API changes. It means that all patches that add new > > +features to the subsystem should also bring changes to the corresponding > > +API files. > > + > > +Also, patches that changes the Open Firmware/Device Tree bindings should > > +also be reviewed by the Device Tree maintainers. > > + > > +Due to the size and wide scope of the media subsystem, media's > > +maintainership model is to have sub-maintainers that have a broad > > +knowledge of an specific aspect of the subsystem. It is a > > +sub-maintainer's task to review the patches, providing feedback to users > > +if the patches are following the subsystem rules and are properly using > > +the media internal and external APIs. > > + > > +Patches for the media subsystem should be sent to the media mailing list > > +at linux-media@xxxxxxxxxxxxxxx as plain text only e-mail. Emails with > > +HTML will be automatically rejected by the mail server. It could be wise > > +to also copy the sub-maintainer(s). > > + > > +Media's workflow is heavily based on Patchwork, meaning that, once a patch > > +is submitted, it should appear at: > > + > > + - https://patchwork.linuxtv.org/project/linux-media/list/ > > + > > +If it doesn't automatically appear there after a few minutes, then > > +probably something got wrong on your submission. Please check if the > > +email is in plain text only and if your emailer is not mangling with > > +whitespaces before complaining or submit it again. > > + > > +Sub-maintainers > > ++++++++++++++++ > > What is the motivation for using "+++" instead of "---"? Just cosmetics. This chapter doesn't exist at the original profile, as sub-maintainers, co-maintainers, etc. are used only on a few subsystems. So, I'm adding it as a sub-chapter. Thanks, Mauro
