* [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; 3+ 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] 3+ 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; 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: [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
0 siblings, 0 replies; 3+ 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] 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