Git development
 help / color / mirror / Atom feed
* [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; 3+ 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] 3+ messages in thread
* Re: Email formatting (was RE: [Outreachy] Draft internship proposal: Improve how command arguments and options are scanned and parsed)
@ 2026-11-17 18:20 Okhuomon Ajayi
  2026-11-17 18:49 ` [PATCH] MyFirstContribution: leave a blank line between mailing-list paragraphs Okhuomon Ajayi
  0 siblings, 1 reply; 3+ messages in thread
From: Okhuomon Ajayi @ 2026-11-17 18:20 UTC (permalink / raw)
  To: Junio C Hamano; +Cc: Richard Kerry, git@vger.kernel.org

On Tue, Nov 17, 2026 at 6:47 PM Junio C Hamano <gitster@pobox.com> wrote:

> I do prefer to see a blank line between paragraphs, and here
> "paragraph" includes a block of "> quoted" text, so I do not mind if
> somebody adds to the documentation near where we talk about the
> line-length limit and line-wrapping such a rule.
>
> Thanks for raising the issue.

Hi Junio,

I can add that to the documentation, next to where we already
talk about the line-length limit and line wrapping: a blank
line between paragraphs, and a quoted block counts as a
paragraph too.

I'll send the patch once it is written.

Thanks,

Okhuomon.

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

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

Thread overview: 3+ 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
  -- 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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox