public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
* [PATCH] Typo in the file 'feature-and-quirk-policy.rst'.
@ 2024-09-09 20:02 cvam
  2024-09-09 20:15 ` Jonathan Corbet
  0 siblings, 1 reply; 6+ messages in thread
From: cvam @ 2024-09-09 20:02 UTC (permalink / raw)
  To: kbusch, axboe
  Cc: hch, sagi, corbet, linux-nvme, linux-doc, linux-kernel, cvam

location: 'Documentation/nvme/feature-and-quirk-policy.rst'
tested: Not breaking anything.
Signed-off-by: cvam <cvam0000@gmail.com>
---
 Documentation/nvme/feature-and-quirk-policy.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/nvme/feature-and-quirk-policy.rst b/Documentation/nvme/feature-and-quirk-policy.rst
index c01d836d8e41..b5461aa303a4 100644
--- a/Documentation/nvme/feature-and-quirk-policy.rst
+++ b/Documentation/nvme/feature-and-quirk-policy.rst
@@ -1,7 +1,7 @@
 .. SPDX-License-Identifier: GPL-2.0
 
 =======================================
-Linux NVMe feature and and quirk policy
+Linux NVMe feature and quirk policy
 =======================================
 
 This file explains the policy used to decide what is supported by the
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* Re: [PATCH] Typo in the file 'feature-and-quirk-policy.rst'.
  2024-09-09 20:02 [PATCH] Typo in the file 'feature-and-quirk-policy.rst' cvam
@ 2024-09-09 20:15 ` Jonathan Corbet
  2024-09-09 20:30   ` Matthew Wilcox
                     ` (2 more replies)
  0 siblings, 3 replies; 6+ messages in thread
From: Jonathan Corbet @ 2024-09-09 20:15 UTC (permalink / raw)
  To: cvam, kbusch, axboe; +Cc: hch, sagi, linux-nvme, linux-doc, linux-kernel, cvam

Thanks for working to improve our documentation.  Some notes...

cvam <cvam0000@gmail.com> writes:

> location: 'Documentation/nvme/feature-and-quirk-policy.rst'
> tested: Not breaking anything.

I don't stress a lot over changelogs for simple tweaks like this, but
you could still try to write something in our normal imperative style.

> Signed-off-by: cvam <cvam0000@gmail.com>

There needs to be a blank line before the signed-off-by, and it should
have a full name in it please.

> ---
>  Documentation/nvme/feature-and-quirk-policy.rst | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/nvme/feature-and-quirk-policy.rst b/Documentation/nvme/feature-and-quirk-policy.rst
> index c01d836d8e41..b5461aa303a4 100644
> --- a/Documentation/nvme/feature-and-quirk-policy.rst
> +++ b/Documentation/nvme/feature-and-quirk-policy.rst
> @@ -1,7 +1,7 @@
>  .. SPDX-License-Identifier: GPL-2.0
>  
>  =======================================
> -Linux NVMe feature and and quirk policy
> +Linux NVMe feature and quirk policy
>  =======================================

A nice touch would be to adjust the width of the "====" lines to match.

Thanks,

jon

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [PATCH] Typo in the file 'feature-and-quirk-policy.rst'.
  2024-09-09 20:15 ` Jonathan Corbet
@ 2024-09-09 20:30   ` Matthew Wilcox
  2024-09-10  2:02   ` Bagas Sanjaya
  2024-09-10  5:27   ` [PATCH v2] Remove duplicate "and" in 'Linux NVMe docs Shivam Chaudhary
  2 siblings, 0 replies; 6+ messages in thread
From: Matthew Wilcox @ 2024-09-09 20:30 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: cvam, kbusch, axboe, hch, sagi, linux-nvme, linux-doc,
	linux-kernel

On Mon, Sep 09, 2024 at 02:15:45PM -0600, Jonathan Corbet wrote:
> >  =======================================
> > -Linux NVMe feature and and quirk policy
> > +Linux NVMe feature and quirk policy
> >  =======================================
> 
> A nice touch would be to adjust the width of the "====" lines to match.

Actually, I wouldn't.  The tooling only complains about lines which are
too short (and honestly, I wish it wouldn't).  Lines which are a bit too
long are fine with the tool, and I don't object to how they look in a
text editor either.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [PATCH] Typo in the file 'feature-and-quirk-policy.rst'.
  2024-09-09 20:15 ` Jonathan Corbet
  2024-09-09 20:30   ` Matthew Wilcox
@ 2024-09-10  2:02   ` Bagas Sanjaya
  2024-09-10  5:27   ` [PATCH v2] Remove duplicate "and" in 'Linux NVMe docs Shivam Chaudhary
  2 siblings, 0 replies; 6+ messages in thread
From: Bagas Sanjaya @ 2024-09-10  2:02 UTC (permalink / raw)
  To: Jonathan Corbet, cvam, kbusch, axboe
  Cc: hch, sagi, linux-nvme, linux-doc, linux-kernel

[-- Attachment #1: Type: text/plain, Size: 532 bytes --]

On Mon, Sep 09, 2024 at 02:15:45PM -0600, Jonathan Corbet wrote:
> cvam <cvam0000@gmail.com> writes:
> 
> > location: 'Documentation/nvme/feature-and-quirk-policy.rst'
> > tested: Not breaking anything.
> 
> I don't stress a lot over changelogs for simple tweaks like this, but
> you could still try to write something in our normal imperative style.

Something like 'Remove duplicate "and" in 'Linux NVMe feature and quirk policy'
title heading.'

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* [PATCH v2] Remove duplicate "and" in 'Linux NVMe docs.
  2024-09-09 20:15 ` Jonathan Corbet
  2024-09-09 20:30   ` Matthew Wilcox
  2024-09-10  2:02   ` Bagas Sanjaya
@ 2024-09-10  5:27   ` Shivam Chaudhary
  2024-09-10 21:45     ` Jonathan Corbet
  2 siblings, 1 reply; 6+ messages in thread
From: Shivam Chaudhary @ 2024-09-10  5:27 UTC (permalink / raw)
  To: kbusch, axboe
  Cc: hch, sagi, corbet, linux-nvme, linux-doc, linux-kernel, cvam

From: cvam <cvam0000@gmail.com>

Remove duplicate occurrence of 'and' in
'Linux NVMe Feature and Quirk Policy' title heading.

tested: Not breaking anything.

Signed-off-by: Shivam Chaudhary <cvam0000@gmail.com>
---
 Documentation/nvme/feature-and-quirk-policy.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/nvme/feature-and-quirk-policy.rst b/Documentation/nvme/feature-and-quirk-policy.rst
index c01d836d8e41..e21966bf20a8 100644
--- a/Documentation/nvme/feature-and-quirk-policy.rst
+++ b/Documentation/nvme/feature-and-quirk-policy.rst
@@ -1,8 +1,8 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-=======================================
-Linux NVMe feature and and quirk policy
-=======================================
+===================================
+Linux NVMe feature and quirk policy
+===================================
 
 This file explains the policy used to decide what is supported by the
 Linux NVMe driver and what is not.
-- 
2.34.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* Re: [PATCH v2] Remove duplicate "and" in 'Linux NVMe docs.
  2024-09-10  5:27   ` [PATCH v2] Remove duplicate "and" in 'Linux NVMe docs Shivam Chaudhary
@ 2024-09-10 21:45     ` Jonathan Corbet
  0 siblings, 0 replies; 6+ messages in thread
From: Jonathan Corbet @ 2024-09-10 21:45 UTC (permalink / raw)
  To: Shivam Chaudhary, kbusch, axboe
  Cc: hch, sagi, linux-nvme, linux-doc, linux-kernel, cvam

Shivam Chaudhary <cvam0000@gmail.com> writes:

> From: cvam <cvam0000@gmail.com>
>
> Remove duplicate occurrence of 'and' in
> 'Linux NVMe Feature and Quirk Policy' title heading.
>
> tested: Not breaking anything.
>
> Signed-off-by: Shivam Chaudhary <cvam0000@gmail.com>
> ---
>  Documentation/nvme/feature-and-quirk-policy.rst | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)

I have applied this, thanks.

For future reference, a remark like "tested: not breaking anything" is
not helpful.  If you have done testing, reviewers will want to know
*how* you have tested it.  For a patch like this, of course, that
doesn't matter.

jon

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2024-09-10 21:45 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-09-09 20:02 [PATCH] Typo in the file 'feature-and-quirk-policy.rst' cvam
2024-09-09 20:15 ` Jonathan Corbet
2024-09-09 20:30   ` Matthew Wilcox
2024-09-10  2:02   ` Bagas Sanjaya
2024-09-10  5:27   ` [PATCH v2] Remove duplicate "and" in 'Linux NVMe docs Shivam Chaudhary
2024-09-10 21:45     ` Jonathan Corbet

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox