editorial

Author: JPryce-Aklundh

modules/ROOT/pages/styleguide.adoc

@@ -10,10 +10,7 @@ The purpose of the Cypher styleguide is to make queries as easy to read as possi
 For rules and recommendations for naming of labels, relationship types and properties, please see the xref::syntax/naming.adoc[Naming rules and recommendations].
 
 The best way to make sure your queries follow the styling rules is to use `cypherfmt`, the official Cypher formatter.
-It is available as part of the https://marketplace.visualstudio.com/items?itemName=neo4j-extensions.neo4j-for-vscode[Neo4j VS Code Extension],
-and as a command line tool through the https://www.npmjs.com/package/@neo4j-cypher/language-support[Neo4j Cypher Language Support npm package].
-
-
+It is available as part of the https://marketplace.visualstudio.com/items?itemName=neo4j-extensions.neo4j-for-vscode[Neo4j VS Code Extension], and as a command line tool through the https://www.npmjs.com/package/@neo4j-cypher/language-support[Neo4j Cypher Language Support npm package].
 
 [[cypher-styleguide-general-recommendations]]
 == General recommendations
@@ -24,7 +21,6 @@ and as a command line tool through the https://www.npmjs.com/package/@neo4j-cyph
 For example: `toString()`.
 * If you are storing Cypher statements in a separate file, use the file extension `.cypher`.
 
-
 [[cypher-styleguide-indentation-and-line-breaks]]
 == Indentation and line breaks
 
@@ -121,8 +117,9 @@ WHERE EXISTS { (a)-->(b:B) }
 RETURN a.prop
 ----
 
-* Limit line length to 80 characters if possible. Line breaks should be applied starting from the outermost group, with each nested group breaking
-until either the line fits or no more line breaks can be inserted. Add two spaces of indentation for each nested broken group.
+* Limit line length to 80 characters if possible.
+Line breaks should be applied starting from the outermost group, with each nested group breaking until either the line fits or no more line breaks can be inserted.
+Add two spaces of indentation for each nested broken group.
 
 .Bad
 [source, cypher]
@@ -145,7 +142,7 @@ WHERE
 RETURN n
 ----
 
-* Start ORDER BY and LIMIT clauses on new lines.
+* Start `ORDER BY` and `LIMIT` clauses on new lines.
 
 .Bad
 [source, cypher]
@@ -163,7 +160,8 @@ ORDER BY n.prop
 LIMIT 10
 ----
 
-* A group containing a CASE expression should always split, and each WHEN, ELSE, and END should be put on a new line. Additionally, WHEN and ELSE should add two spaces of indentation.
+* A group containing a `CASE` expression should always break, and each `WHEN`, `ELSE`, and `END` should be put on a new line.
+Additionally, `WHEN` and `ELSE` should add two spaces of indentation.
 
 .Bad
 [source, cypher]
@@ -180,11 +178,11 @@ RETURN
   CASE
     WHEN n.age >= 18 THEN 'Adult'
     ELSE 'Minor'
-  END AS ageGroup-
+  END AS ageGroup
 ----
 
-* Lines that end with a list or map literal and do not fit within the maximum width should leave
-the opening bracket/brace on the previous line and use only two additional spaces of indentation.
+* Lines that end with a list or map literal and do not fit within the maximum width should leave the opening bracket or brace on the preceding line.
+The contents of the literal should be indented two additional spaces from the line where the opening bracket or brace appears.
 
 .Bad
 [source, cypher]