From: Sakari Ailus <sakari.ailus@iki.fi>
To: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Cc: linux-media@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
workflows@vger.kernel.org, Hans Verkuil <hverkuil@xs4ll.nl>,
Ricardo Ribalda <ribalda@chromium.org>
Subject: Re: [PATCH v3 2/3] docs: media: document media multi-committers rules and process
Date: Tue, 3 Dec 2024 10:03:23 +0000 [thread overview]
Message-ID: <Z07Xawtb_JpH_upp@valkosipuli.retiisi.eu> (raw)
In-Reply-To: <20241203092613.4e7b3a21@foz.lan>
Hi Mauro,
On Tue, Dec 03, 2024 at 09:26:13AM +0100, Mauro Carvalho Chehab wrote:
> > > +is also based on a trust relationship between the rest of the committers,
> >
> > s/also//
> > s/between the rest of/among/
> >
> > I wonder if we should add here some expectation on being reachable on
> > #linux-media.
>
> I'll add it at the note about linuxtv.org:
>
> These commit rights are granted with expectation of responsibility:
> committers are people who care about the Linux Kernel as a whole and
> about the Linux media subsystem and want to advance its development. It
> is also based on a trust relationship among other committers, maintainers
> and the Linux Media community[1].
>
> ...
>
>
> [1] The Linux Media Community, also called LinuxTV Community, has its primary
> site at https://linuxtv.org.
>
> Media committers and developers are reachable via the #linux-media
> IRC channel at OFTC.
Looks good, thanks!
>
> > > +maintainers and the Linux Media community[1].
> > > +
> > > +As such, a media committer is not just someone who is capable of creating
> > > +code, but someone who has demonstrated their ability to collaborate
> > > +with the team, get the most knowledgeable people to review code,
> > > +contribute high-quality code, and follow through to fix issues (in code
> > > +or tests).
> > > +
> > > +.. Note::
> > > +
> > > + 1. If a patch introduces a regression, then it is the media committer's
> > > + responsibility to correct that as soon as possible. Typically the
> > > + patch is either reverted, or an additional patch is committed that
> > > + fixes the regression;
> >
> > s/that fixes/to fix/
>
> Ok.
>
> >
> > > + 2. if patches are fixing bugs against already released Kernels, including
> > > + the reverts above mentioned, the media committer shall add the needed
> > > + tags. Please see :ref:`Media development workflow` for more details.
> >
> > Does this reference work?
>
> Yes. Tested on Sphinx 6.2.0.
>
> > > +[1] The Linux Media community, also called LinuxTV community, has its primary
> > > + site at https://linuxtv.org.
> > > +
> > > +Becoming a media committer
> > > +--------------------------
> > > +
> > > +The most important aspect of volunteering to be a committer is that you have
> > > +demonstrated the ability to give good code reviews. So we are looking for
> >
> > I wonder if we should add some kind of an expectation of demonstrating
> > common sense? :-)
>
> Could you propose some text for that?
How about:
The most important aspects of volunteering to be a committer are that you
have demonstrated the ability to give good code reviews, interacting with
others in the community as well as common sense. These are what we're
looking for when we're judging whether you'd be a good Media committer.
>
> > > +whether or not we think you will be good at doing that.
> > > +
> > > +As such, potential committers must earn enough credibility and trust from the
> > > +LinuxTV community. To do that, developers shall be familiar with the open
> > > +source model and have been active in the Linux Kernel community for some time,
> > > +and, in particular, in the media subsystem.
> > > +
> > > +So, in addition to actually making the code changes, you are basically
> > > +demonstrating your:
> > > +
> > > +- commitment to the project;
> > > +- ability to collaborate with the team and communicate well;
> > > +- understand of how upstream and the LinuxTV community work
> > > + (policies, processes for testing, code review, ...)
> > > +- reasonable knowledge about:
> > > +
> > > + - the Kernel development process:
> > > + Documentation/process/index.rst
> >
> > :ref:`the Kernel development process <process_index>`
>
> No need. a Sphinx converts all *.rst into references automatically.
>
> Better to use RST files at the text, as makes easier for people
> reading the text file directly.
Ack.
>
> > > +
> > > + - the Media development profile:
> > > + Documentation/driver-api/media/maintainer-entry-profile.rst
> >
> > Could you add a label to the title and refer to it directly?
>
> Same as above.
>
> > > +
> > > +- understanding of the projects' code base and coding style;
> > > +- ability to provide feedback to the patch authors;
> > > +- ability to judge when a patch might be ready for review and to submit;
> > > +- ability to write good code (last but certainly not least).
> > > +
> > > +Developers that intend to become committers are encouraged to participate
> >
> > s/intend/yearn/
>
> Heh, I had to go to the dictionary to seek for "yearn" meaning ;-)
>
> Let's use a simpler language, as most developers are not native-English
> speakers. I did:
>
> s/intend/desire/
>
> which is a synonym.
Works for me.
--
Kind regards,
Sakari Ailus
next prev parent reply other threads:[~2024-12-03 10:03 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-12-02 9:26 [PATCH v3 0/3] Document the new media-committer's model Mauro Carvalho Chehab
2024-12-02 9:26 ` [PATCH v3 1/3] docs: media: update maintainer-entry-profile for multi-committers Mauro Carvalho Chehab
2024-12-02 12:40 ` Sakari Ailus
2024-12-02 13:23 ` Mauro Carvalho Chehab
2024-12-03 11:52 ` Sakari Ailus
2024-12-02 13:17 ` Hans Verkuil
2024-12-02 13:54 ` Mauro Carvalho Chehab
2024-12-02 14:49 ` Hans Verkuil
2024-12-02 20:48 ` Ricardo Ribalda
2024-12-02 9:26 ` [PATCH v3 2/3] docs: media: document media multi-committers rules and process Mauro Carvalho Chehab
2024-12-02 14:13 ` Sakari Ailus
2024-12-03 8:26 ` Mauro Carvalho Chehab
2024-12-03 10:03 ` Sakari Ailus [this message]
2024-12-02 14:37 ` Hans Verkuil
2024-12-02 9:26 ` [PATCH v3 3/3] docs: media: profile: make it clearer about maintainership duties Mauro Carvalho Chehab
2024-12-02 14:40 ` Hans Verkuil
2024-12-02 14:48 ` Sakari Ailus
2024-12-03 9:28 ` Mauro Carvalho Chehab
2024-12-03 12:49 ` Sakari Ailus
2024-12-02 15:03 ` [PATCH v3 0/3] Document the new media-committer's model Hans Verkuil
2024-12-03 7:19 ` Mauro Carvalho Chehab
2024-12-03 11:22 ` Laurent Pinchart
2024-12-03 13:07 ` Mauro Carvalho Chehab
2024-12-09 8:15 ` Media committers model postponed to 6.14 - Was: " Mauro Carvalho Chehab
2025-02-07 11:54 ` Hans Verkuil
2025-02-10 7:00 ` Mauro Carvalho Chehab
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=Z07Xawtb_JpH_upp@valkosipuli.retiisi.eu \
--to=sakari.ailus@iki.fi \
--cc=corbet@lwn.net \
--cc=hverkuil@xs4ll.nl \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=mchehab+huawei@kernel.org \
--cc=ribalda@chromium.org \
--cc=workflows@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®