From 53b4f06b923d4cf9b8e371abd22eed6e21bde15a Mon Sep 17 00:00:00 2001
From: Geraldine Van der Auwera <geraldinevdauwera@gmail.com>
Date: Tue, 27 May 2025 22:57:02 -0400
Subject: [PATCH] Update CONTRIBUTING.md

Add guidance regarding paragraphs
---
 CONTRIBUTING.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 6269fe644..05d044cea 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -131,6 +131,11 @@ Please make sure that you have Prettier installed and working locally: <https://
 
 There is a GitHub action that checks pull-requests for valid formatting.
 
+For paragraphs containing multiple sentences, please start each sentence on a new line.
+Doing that produces cleaner diffs for future code reviews.
+The sentences will still be rendered as a continuous paragraph.
+For an example, have a look at the code for this paragraph.
+
 ### Admonitions
 
 We use admonitions extensively to make certain pieces of content stand out.