Merge branch 'master' into copy-edit-bolts

.copy-edit-stylesheet-checklist.md

@@ -1,5 +1,5 @@
-Basic checklist/stylesheet used for copy editing BOLTs.
-Temporarily included here for reference purposes.
+Basic checklist/stylesheet used for copy editing BOLTs,
+temporarily included here for reference purposes.
 
   - spelling
   - typos
@@ -7,6 +7,8 @@ Temporarily included here for reference purposes.
     - sentence fragments
     - run-on sentences
     - dangling, misplaced modifiers
+    - consistent paragraph tense (e.g. past, present, future)
+    - passive voice (e.g. avoid 'we')
   - capitalization
     - table of contents
     - headers
@@ -27,19 +29,20 @@ Temporarily included here for reference purposes.
       - comma before 'and' item
       - period at branch ends
       - example:
-      >A sending node:
-        - MAY do this.
-        - if this:
-          - SHOULD do this.
-        - else:
-          - MUST do this,
-          - and MUST NOT do this.
-
+      ```
+      A sending node:
+          - MAY do this.
+            - if this:
+              - SHOULD do this.
+            - else:
+              - MUST do this,
+              - and MUST NOT do this.
+      ```
   - links
     - broken links
     - link text
     - correct anchors/urls
   - references
-    - e.g. <sup>[1](#reference-1)</sup>
+    - format e.g. <sup>[1](#reference-1)</sup>
   - tags
     - consistent usage, e.g. [TODO:], [FIXME:]

01-messaging.md

@@ -240,8 +240,8 @@ Connections between nodes within the network may be very long lived, as payment
 channels have an indefinite lifetime. However, it's likely that for a
 significant portion of the lifetime of a connection, no new data will be
 exchanged. Also, on several platforms it's possible that Lightning
-clients will be put to sleep without prior warning. Hence, we use a
-distinct `ping` message, in order to probe for the liveness of the connection on
+clients will be put to sleep without prior warning. Hence, a
+distinct `ping` message is used, in order to probe for the liveness of the connection on
 the other side, as well as to keep the established connection active.
 
 Additionally, the ability for a sender to request that the receiver send a