# [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs

3 messages from 2026-11-18 to 2026-11-18. Participants: Okhuomon Ajayi, Junio C Hamano.
Thread: https://gitlist.dev/t/66871

## Okhuomon Ajayi, 2026-11-18 10:52

Subject: [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
Message-ID: <20261118105227.50447-1-okhuomonajayi54@gmail.com>
URL: https://gitlist.dev/e/20261118105227.50447-1-okhuomonajayi54%40gmail.com

```
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



```

## Junio C Hamano, 2026-11-18 18:35

Subject: Re: [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
Message-ID: <xmqqy0aq56oj.fsf@gitster.g>
URL: https://gitlist.dev/e/xmqqy0aq56oj.fsf%40gitster.g
In-Reply-To: <20261118105227.50447-1-okhuomonajayi54@gmail.com>

```
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.


```

## Okhuomon Ajayi, 2026-11-18 23:54

Subject: Re: [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs
Message-ID: <CAFpMFfDOGZUFPRfPkCXZyO5hJ1O7gfjzTnv6Djs=EMPd0VmfuQ@mail.gmail.com>
URL: https://gitlist.dev/e/CAFpMFfDOGZUFPRfPkCXZyO5hJ1O7gfjzTnv6Djs%3DEMPd0VmfuQ%40mail.gmail.com
In-Reply-To: <xmqqy0aq56oj.fsf@gitster.g>

```
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


```
