nep1: triple quote literals should start with newline (#17065)

1 files changed, 21 insertions, 0 deletions

diff --git a/doc/nep1.rst b/doc/nep1.rst
index 052837b90..c0ae16706 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
+    """