[PATCH] docs: improve introduction wording in howto.rst

ᴋᴀʀᴛɪᴋ sʜᴀʜ posted 1 patch 1 week, 5 days ago
There is a newer version of this series
Documentation/process/howto.rst | 12 ++----------
1 file changed, 2 insertions(+), 10 deletions(-)
[PATCH] docs: improve introduction wording in howto.rst
Posted by ᴋᴀʀᴛɪᴋ sʜᴀʜ 1 week, 5 days ago
From 48d7e03ca7278705283d95b7da75739b97996a66 Mon Sep 17 00:00:00 2001
From: kartikpro9599-hash <kartikpro9599@gmail.com>
Date: Sun, 7 Dec 2025 11:35:19 +0530
Subject: [PATCH] docs: improve introduction wording in howto.rst

Signed-off-by: kartikpro9599-hash <kartikpro9599@gmail.com>
---
 Documentation/process/howto.rst | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/Documentation/process/howto.rst b/Documentation/process/howto.rst
index 9438e03d6..7c7fc331c 100644
--- a/Documentation/process/howto.rst
+++ b/Documentation/process/howto.rst
@@ -2,16 +2,8 @@

 HOWTO do Linux kernel development
 =================================
-
-This is the be-all, end-all document on this topic.  It contains
-instructions on how to become a Linux kernel developer and how to learn
-to work with the Linux kernel development community.  It tries to not
-contain anything related to the technical aspects of kernel programming,
-but will help point you in the right direction for that.
-
-If anything in this document becomes out of date, please send in patches
-to the maintainer of this file, who is listed at the bottom of the
-document.
+This is a complete introductory document on this topic. It contains
instructions on how to become a Linux kernel developer and how to work
with the Linux kernel development community. It does not cover the
technical aspects of kernel programming, but will help point you in
the right direction for that.
+If anything in this document becomes out of date, please send in
patches to the maintainer of this file, who is listed at the bottom of
the document.


 Introduction
-- 
2.52.0.windows.1
Re: [PATCH] docs: improve introduction wording in howto.rst
Posted by Randy Dunlap 1 week, 5 days ago
Hi,

On 12/6/25 10:14 PM, ᴋᴀʀᴛɪᴋ sʜᴀʜ wrote:
> From 48d7e03ca7278705283d95b7da75739b97996a66 Mon Sep 17 00:00:00 2001
> From: kartikpro9599-hash <kartikpro9599@gmail.com>
> Date: Sun, 7 Dec 2025 11:35:19 +0530
> Subject: [PATCH] docs: improve introduction wording in howto.rst
> 
> Signed-off-by: kartikpro9599-hash <kartikpro9599@gmail.com>
> ---
>  Documentation/process/howto.rst | 12 ++----------
>  1 file changed, 2 insertions(+), 10 deletions(-)
> 
> diff --git a/Documentation/process/howto.rst b/Documentation/process/howto.rst
> index 9438e03d6..7c7fc331c 100644
> --- a/Documentation/process/howto.rst
> +++ b/Documentation/process/howto.rst
> @@ -2,16 +2,8 @@
> 
>  HOWTO do Linux kernel development
>  =================================
> -
> -This is the be-all, end-all document on this topic.  It contains
> -instructions on how to become a Linux kernel developer and how to learn
> -to work with the Linux kernel development community.  It tries to not
> -contain anything related to the technical aspects of kernel programming,
> -but will help point you in the right direction for that.
> -
> -If anything in this document becomes out of date, please send in patches
> -to the maintainer of this file, who is listed at the bottom of the
> -document.

Something seems to be wrong with the patch here:

> +This is a complete introductory document on this topic. It contains
> instructions on how to become a Linux kernel developer and how to work
> with the Linux kernel development community. It does not cover the
> technical aspects of kernel programming, but will help point you in
> the right direction for that.
> +If anything in this document becomes out of date, please send in
> patches to the maintainer of this file, who is listed at the bottom of
> the document.

Each line that is changed (added or deleted) should have a '+' or '-'
(respectively) as its first character.
I cannot apply this patch in this form:
patch: **** malformed patch at line 38: instructions on how to become a Linux kernel developer and how to work

Did you send it to yourself and then try to apply it?

And the second part (last 3 lines above) don't need to be changed.
They are the same as the current content of the file and don't need
to be touched.


thanks.
-- 
~Randy