* [PATCH v3] docs: Fix grammar and phrasing errors in reporting-issues.rst
@ 2024-08-16 9:36 SurajSonawane2415
2024-08-16 9:58 ` Thorsten Leemhuis
0 siblings, 1 reply; 2+ messages in thread
From: SurajSonawane2415 @ 2024-08-16 9:36 UTC (permalink / raw)
To: linux; +Cc: corbet, linux-doc, linux-kernel, SurajSonawane2415
Fix grammatical errors and improve phrasing in the `reporting-issues.rst`
documentation file. These changes enhance readability and ensure the
accuracy of the instructions provided.
Signed-off-by: SurajSonawane2415 <surajsonawane0215@gmail.com>
---
V2 -> V3: Re-added the fix for the line: "That's why you might be need to uninstall the".
V1 -> V2: emoved the unwanted change to the line: "try search terms like".
Documentation/admin-guide/reporting-issues.rst | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/admin-guide/reporting-issues.rst b/Documentation/admin-guide/reporting-issues.rst
index 2fd5a030235a..07b2c0b20498 100644
--- a/Documentation/admin-guide/reporting-issues.rst
+++ b/Documentation/admin-guide/reporting-issues.rst
@@ -56,7 +56,7 @@ developers. It might be all that's needed for people already familiar with
reporting issues to Free/Libre & Open Source Software (FLOSS) projects. For
everyone else there is this section. It is more detailed and uses a
step-by-step approach. It still tries to be brief for readability and leaves
-out a lot of details; those are described below the step-by-step guide in a
+out a lot of details; those are described below in the step-by-step guide in a
reference section, which explains each of the steps in more detail.
Note: this section covers a few more aspects than the TL;DR and does things in
@@ -299,7 +299,7 @@ face, even if they look small or totally unrelated. That's why you should report
issues with these kernels to the vendor. Its developers should look into the
report and, in case it turns out to be an upstream issue, fix it directly
upstream or forward the report there. In practice that often does not work out
-or might not what you want. You thus might want to consider circumventing the
+or might not be what you want. You thus might want to consider circumventing the
vendor by installing the very latest Linux kernel core yourself. If that's an
option for you move ahead in this process, as a later step in this guide will
explain how to do that once it rules out other potential causes for your issue.
@@ -472,7 +472,7 @@ before proceeding.
Note, you might not be aware that your system is using one of these solutions:
they often get set up silently when you install Nvidia's proprietary graphics
driver, VirtualBox, or other software that requires a some support from a
-module not part of the Linux kernel. That why your might need to uninstall the
+module not part of the Linux kernel. That's why you might be need to uninstall the
packages with such software to get rid of any 3rd party kernel module.
--
2.34.1
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: [PATCH v3] docs: Fix grammar and phrasing errors in reporting-issues.rst
2024-08-16 9:36 [PATCH v3] docs: Fix grammar and phrasing errors in reporting-issues.rst SurajSonawane2415
@ 2024-08-16 9:58 ` Thorsten Leemhuis
0 siblings, 0 replies; 2+ messages in thread
From: Thorsten Leemhuis @ 2024-08-16 9:58 UTC (permalink / raw)
To: SurajSonawane2415; +Cc: corbet, linux-doc, linux-kernel
On 16.08.24 11:36, SurajSonawane2415 wrote:
> Fix grammatical errors and improve phrasing in the `reporting-issues.rst`
> documentation file. These changes enhance readability and ensure the
> accuracy of the instructions provided.
>
> Signed-off-by: SurajSonawane2415 <surajsonawane0215@gmail.com>
> ---
> V2 -> V3: Re-added the fix for the line: "That's why you might be need to uninstall the".
> V1 -> V2: emoved the unwanted change to the line: "try search terms like".
Thx, description sounds good. Final verdict ist up to Jonathan. And
changelog is great as well (apart from the typo in "removed", but
things happen, so no worries :-D )
Sadly there is one more thing where I apparently was unclear earlier:
> @@ -472,7 +472,7 @@ before proceeding.
> Note, you might not be aware that your system is using one of these solutions:
> they often get set up silently when you install Nvidia's proprietary graphics
> driver, VirtualBox, or other software that requires a some support from a
> -module not part of the Linux kernel. That why your might need to uninstall the
> +module not part of the Linux kernel. That's why you might be need to uninstall the
> packages with such software to get rid of any 3rd party kernel module.
That last "the" makes the line too long, so it needs to move to the next
line. The diff thus should look like this in the end:
-module not part of the Linux kernel. That why your might need to uninstall the
+module not part of the Linux kernel. That's why you might be need to uninstall
+the packages with such software to get rid of any 3rd party kernel module.
But wait a moment: that additional "be" looks wrong to me. If you agree,
remove it and resend, then everything will be fine afaics. Sorry, I
should have noticed that earlier.
Ciao, Thorsten
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2024-08-16 9:58 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-08-16 9:36 [PATCH v3] docs: Fix grammar and phrasing errors in reporting-issues.rst SurajSonawane2415
2024-08-16 9:58 ` Thorsten Leemhuis
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®