Merge branch 'master' into remove-glossary

Author: Ruben Schmidmeister

documentation/src/basic-constructs.md

@@ -65,7 +65,21 @@ return condition
 ```
 *ternary operator*
 
-## Expression-bodied members
+## 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*
+
+## 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.

documentation/src/physical-structure.md

@@ -2,8 +2,8 @@
 
 ## Each class should go into its own file with the same name
 
-Only one class should be in a file. This also applies to an Enumerations.
-Inner classes are allowed but discouraged and an obvious exception to this rule. 
+Only one class should be in a file. This also applies to enumeration types (`enum`).
+Inner classes are allowed but discouraged.
 
 ## Each namespace should go into its own folder with the same name