From 8162c47b0f2b5970a876dc9cc1ed434bc5e6e789 Mon Sep 17 00:00:00 2001
From: Timothee Cour <timothee.cour2@gmail.com>
Date: Thu, 18 Feb 2021 11:14:10 -0800
Subject: [PATCH] nep1: triple quote literals should start with newline
 (#17065)

---
 doc/nep1.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/nep1.rst b/doc/nep1.rst
index 052837b900..c0ae16706b 100644
--- a/doc/nep1.rst
+++ b/doc/nep1.rst
@@ -281,5 +281,26 @@ Conventions for multi-line statements and expressions
     startProcess(nimExecutable, currentDirectory, compilerArguments
                  environment, processOptions)
 
+Miscellaneous
+-------------
+
 - Use `a..b` instead of `a .. b`, except when `b` contains an operator, for example `a .. -3`.
   Likewise with `a..<b`, `a..^b` and other operators starting with `..`.
+
+- Prefer triple quote literals to start with a newline; it's semantically identical
+  (it's a feature of triple quote literals) but clearer because it aligns with the next line:
+
+  use this:
+
+  .. code-block:: nim
+    let a = """
+    foo
+    bar
+    """
+
+  instead of:
+
+  .. code-block:: nim
+    let a = """foo
+    bar
+    """