Merge remote-tracking branch 'origin/master' into add-links

Author: Ruben Schmidmeister

documentation/src/SUMMARY.md

@@ -7,6 +7,7 @@
 * [Naming Conventions](./naming.md)
 * [Variables](./variables.md)
 * [Basic constructs](./basic-constructs.md)
+* [Expressions](./expressions.md)
 * [Types](./types.md)
 * [Functional Programming](./functional.md)
 * [Object oriented programming](./oop.md)

documentation/src/basic-constructs.md

@@ -4,28 +4,6 @@
 
 Multiple expressions or statements in one line increase the mental burden while reading them. Split them up to avoid mentally hiding statements.
 
-## Prefer logical operators to if statements
-
-```csharp
-if (node.GetParenthesis(key))
-{
-    item.Setting = false;
-}
-else
-{
-    item.Setting = true;
-}
-```
-*Avoid if and ternary operator for logical expressions*
-
-Logical expressions have no branches, are more concise and always handle all the logical cases.
-
-```csharp
-item.Setting = !GetParenthesis(key);
-```
-*Use logical operators `!`, `&&` and `||`*
-
-
 ## If-statements
 
 The condition of the if-statement should have no side effects.
@@ -59,50 +37,6 @@ if (!updateIsReady)
 ```
 *Better alternative*
 
-## ternary operator
-
-Prefer the ternary operator to simple if statements. The ternary operator is an expression in contrast to the if-statement and it forces you to handle all the cases.
-
-We format the ternary operator like this, to see which branch we are dealing with easily.
-
-```csharp
-return condition
-    ? true-expression
-    : false-expression;
-```
-*ternary operator*
-
-## Switch Expression
-
-Prefer [switch expressions] over switch statements.
-
-```csharp
-return animalKind switch
-{
-    AnimalKind.Dog => "dog",
-    AnimalKind.Cat => "cat",
-    _ => throw new InvalidOperationException($"Unsupported animal kind {animalKind}"),
-};
-```
-*switch expression*
-
-[switch expressions]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/operators/switch-expression
-
-## Expression-bodied Members
-
-Use the [expression body syntax] when a member returns a single expression.
-Move the arrow to the next line when the expression gets too long.
-
-```csharp
-public int Length => 0;
-
-public string AbsolutePath()
-    => Path.Combine(CalculateRootPath(), RelativePath);
-```
-*expression-bodied members*
-
-[expression body syntax]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members
-
 ## For-loops
 
 Avoid for-loops and use LINQ and higher order functions as an alternative.

documentation/src/expressions.md

@@ -0,0 +1,68 @@
+# Expressions
+
+Prefer expressions over statements.
+
+## Prefer logical operators to if statements
+
+```csharp
+if (node.GetParenthesis(key))
+{
+    item.Setting = false;
+}
+else
+{
+    item.Setting = true;
+}
+```
+*Avoid if and ternary operator for logical expressions*
+
+Logical expressions have no branches, are more concise and always handle all the logical cases.
+
+```csharp
+item.Setting = !GetParenthesis(key);
+```
+*Use logical operators `!`, `&&` and `||`*
+
+## ternary operator
+
+Prefer the ternary operator to simple if statements. The ternary operator is an expression in contrast to the if-statement and it forces you to handle all the cases.
+
+We format the ternary operator like this, to see which branch we are dealing with easily.
+
+```csharp
+return condition
+    ? true-expression
+    : false-expression;
+```
+*ternary operator*
+
+## Switch Expression
+
+Prefer [switch expressions] over switch statements.
+
+```csharp
+return animalKind switch
+{
+    AnimalKind.Dog => "dog",
+    AnimalKind.Cat => "cat",
+    _ => throw new InvalidOperationException($"Unsupported animal kind {animalKind}"),
+};
+```
+*switch expression*
+
+[switch expressions]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/operators/switch-expression
+
+## Expression-bodied Members
+
+Use the [expression body syntax] when a member returns a single expression.
+Move the arrow to the next line when the expression gets too long.
+
+```csharp
+public int Length => 0;
+
+public string AbsolutePath()
+    => Path.Combine(CalculateRootPath(), RelativePath);
+```
+*expression-bodied members*
+
+[expression body syntax]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/statements-expressions-operators/expression-bodied-members