All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
  2026-11-17 18:20 Email formatting (was RE: [Outreachy] Draft internship proposal: Improve how command arguments and options are scanned and parsed) Okhuomon Ajayi
@ 2026-11-17 18:49 ` Okhuomon Ajayi
  0 siblings, 0 replies; 4+ messages in thread
From: Okhuomon Ajayi @ 2026-11-17 18:49 UTC (permalink / raw)
  To: git

A short reply is hard to spot when it is packed against a long run
of quoted lines. Leave a blank line between paragraphs. A block of
quoted text counts as a paragraph.

Signed-off-by: Okhuomon Ajayi <okhuomonajayi54@gmail.com>
---
This is the documentation change mentioned in the previous message.

 Documentation/MyFirstContribution.adoc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc
index c58253fd54..9c189b6c9e 100644
--- a/Documentation/MyFirstContribution.adoc
+++ b/Documentation/MyFirstContribution.adoc
@@ -1357,6 +1357,9 @@ relevant to your response. It is usually helpful to trim away unrelated context,
 such as large portions of the patch that are not being discussed, while keeping
 enough quoted text for readers to understand what you are responding to.
 
+Leave a blank line between paragraphs. A block of quoted text counts
+as a paragraph, so leave a blank line before and after it.
+
 Make sure your email client has a plaintext email mode and it is turned on; the
 Git list rejects HTML email. Please also follow the mailing list etiquette
 outlined in the

base-commit: 7fb6055e678f800320d8ab8cd8f201d9493d1ba0
-- 
2.56.0


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

* [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
@ 2026-11-18 10:52 Okhuomon Ajayi
  2026-11-18 18:35 ` Junio C Hamano
  0 siblings, 1 reply; 4+ messages in thread
From: Okhuomon Ajayi @ 2026-11-18 10:52 UTC (permalink / raw)
  To: git

A short reply is hard to spot when it is packed against a long run
of quoted lines. Leave a blank line between paragraphs. A block of
quoted text counts as a paragraph.

Signed-off-by: Okhuomon Ajayi <okhuomonajayi54@gmail.com>
---
 Documentation/MyFirstContribution.adoc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc
index c58253fd54..9c189b6c9e 100644
--- a/Documentation/MyFirstContribution.adoc
+++ b/Documentation/MyFirstContribution.adoc
@@ -1357,6 +1357,9 @@ relevant to your response. It is usually helpful to trim away unrelated context,
 such as large portions of the patch that are not being discussed, while keeping
 enough quoted text for readers to understand what you are responding to.
 
+Leave a blank line between paragraphs. A block of quoted text counts
+as a paragraph, so leave a blank line before and after it.
+
 Make sure your email client has a plaintext email mode and it is turned on; the
 Git list rejects HTML email. Please also follow the mailing list etiquette
 outlined in the

base-commit: 7fb6055e678f800320d8ab8cd8f201d9493d1ba0
-- 
2.56.0


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

* Re: [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
  2026-11-18 10:52 [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs Okhuomon Ajayi
@ 2026-11-18 18:35 ` Junio C Hamano
  2026-11-18 23:54   ` Okhuomon Ajayi
  0 siblings, 1 reply; 4+ messages in thread
From: Junio C Hamano @ 2026-11-18 18:35 UTC (permalink / raw)
  To: Okhuomon Ajayi; +Cc: git

Okhuomon Ajayi <okhuomonajayi54@gmail.com> writes:

> diff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc
> index c58253fd54..9c189b6c9e 100644
> --- a/Documentation/MyFirstContribution.adoc
> +++ b/Documentation/MyFirstContribution.adoc
> @@ -1357,6 +1357,9 @@ relevant to your response. It is usually helpful to trim away unrelated context,
>  such as large portions of the patch that are not being discussed, while keeping
>  enough quoted text for readers to understand what you are responding to.
>  
> +Leave a blank line between paragraphs. A block of quoted text counts
> +as a paragraph, so leave a blank line before and after it.
> +
>  Make sure your email client has a plaintext email mode and it is turned on; the
>  Git list rejects HTML email. Please also follow the mailing list etiquette
>  outlined in the

Sounds like a good way to help readability.  I didn't expect this
patch to extend MyFirstContribution, as the first chance for anybody
has to deal with "quoted text" is when writing a response to other's
patch during a review, not when responding to a review, but it seems
that CodingGuidelines, Submittingpatches, and ReviewingGuidelines do
not even talk about line length limit for e-mailed communications
(which is a bit surprising).

Will queue.  Thanks.

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

* Re: [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
  2026-11-18 18:35 ` Junio C Hamano
@ 2026-11-18 23:54   ` Okhuomon Ajayi
  0 siblings, 0 replies; 4+ messages in thread
From: Okhuomon Ajayi @ 2026-11-18 23:54 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: git

On Wed, Nov 18, 2026 at 7:35 PM Junio C Hamano <gitster@pobox.com> wrote:

> Sounds like a good way to help readability.  I didn't expect this
> patch to extend MyFirstContribution, as the first chance for anybody
> has to deal with "quoted text" is when writing a response to other's
> patch during a review, not when responding to a review, but it seems
> that CodingGuidelines, Submittingpatches, and ReviewingGuidelines do
> not even talk about line length limit for e-mailed communications
> (which is a bit surprising).
>
> Will queue.  Thanks.

Thanks Junio.

I am working on a separate patch for the line-length limit. It
states the limit in CodingGuidelines, SubmittingPatches, and
ReviewingGuidelines.

Okhuomon

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

end of thread, other threads:[~2026-11-18 23:54 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-11-18 10:52 [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs Okhuomon Ajayi
2026-11-18 18:35 ` Junio C Hamano
2026-11-18 23:54   ` Okhuomon Ajayi
  -- strict thread matches above, loose matches on Subject: below --
2026-11-17 18:20 Email formatting (was RE: [Outreachy] Draft internship proposal: Improve how command arguments and options are scanned and parsed) Okhuomon Ajayi
2026-11-17 18:49 ` [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs Okhuomon Ajayi

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.