Request for tasks regarding Checkpatch Documentation mentorship program (LFX)
lukas.bulwahn at gmail.com
Sat Jul 31 08:27:07 UTC 2021
On Sat, Jul 31, 2021 at 10:14 AM Rahul Balaji <rahulbalaji78 at gmail.com> wrote:
> Respected sir,
> I am interested in working on the checkpath documentation project under your mentorship and would like to work on tasks for the selection process.
The zeroth task is to learn suitable netiquette for the communication
with the kernel community. Below are some basic rules and pointers for
this mentorship. More information on kernel netiquette is also at
First, please do not top-post.
A: Because we read from top to bottom, left to right.
Q: Why should I start my reply below the quoted text?
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: The lost context.
Q: What makes top-posted replies harder to read than bottom-posted?
Q: Should I trim down the quoted part of an email to which I'm replying?
Second, please always CC: linux-kernel-mentees at lists.linuxfoundation.org.
Third, set up your email client according to the kernel community rules.
Here is some information to that:
Generally more information on submitting patches and responding on
replies is at https://www.kernel.org/doc/html/latest/process/submitting-patches.html
Once the zeroth task is understood, you can now move on to the first
task: Running checkpatch on a specific file
Get a clone of the Linux kernel repository. The script checkpatch.pl
is under the scripts directory.
Then, the first task is to run checkpatch.pl on a few files below and
share the results:
Which information on these rules that checkpatch warns about is
available in the Checkpatch Documentation?
If documentation of these rules is available, explain your
understanding of the rules in your own words.
If no information is available in the documentation, explain your
understanding of the rule.
In any case, explain the violation that is checked and raised in the
checkpatch script, i.e., what is implemented in checkpatch to check
the rule and possible violations. Explain how to possibly fix this
code with regards to that violation.
Once you succeed on this first task, we inform you about the further
second and third task.
If you fail on any of those tasks, you are out of the selection process.
The selection of the mentee will happen according to schedule, at
earliest on August 12th and at latest at the end of August. More
information is available at
More information about the Linux-kernel-mentees