Docs: improve documentation for Squiz.WhiteSpace.ScopeClosingBrace

- Fixup CDATA indentation
- Improve wording in code examples
- Add more varied code examples

Author: jaymcp

src/Standards/Squiz/Docs/WhiteSpace/ScopeClosingBraceStandard.xml

@@ -1,25 +1,63 @@
 <documentation title="Scope Closing Brace">
     <standard>
     <![CDATA[
-    Closing brace indentation must match opening brace.
+    Indentation of a closing brace must match the indentation of the line containing the opening brace.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Closing brace indented correctly.">
+        <code title="Valid: Closing brace aligned with opening brace.">
         <![CDATA[
 function foo()
-<em>{</em>
-    echo 'hi';
-}
-]]>
+{
+    echo 'opening brace at column 1';
+    echo 'closing brace at column 1';
+<em>}</em>
+        ]]>
         </code>
-        <code title="Invalid: Closing brace indented incorrectly.">
+        <code title="Invalid: Closing brace misaligned with opening brace.">
         <![CDATA[
 function foo()
 {
-    echo 'hi';
+    echo 'opening brace at column 1';
+    echo 'closing brace at column 2';
 <em> }</em>
-]]>
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Closing brace aligned with class keyword.">
+        <![CDATA[
+class Foo {
+    echo 'class keyword starts at column 1';
+    echo 'closing brace at column 1';
+<em>}</em>
+        ]]>
+        </code>
+        <code title="Invalid: Closing brace misaligned with class keyword.">
+        <![CDATA[
+class Foo {
+    echo 'class keyword starts at column 1';
+    echo 'closing brace at column 2';
+<em> }</em>
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Closing brace aligned with if keyword.">
+        <![CDATA[
+if ($a > $b) {
+    echo 'conditional starts at column 1';
+    echo 'closing brace at column 1';
+<em>}</em>
+        ]]>
+        </code>
+        <code title="Invalid: Closing brace aligned with content.">
+        <![CDATA[
+if ($a > $b) {
+    echo 'conditional starts at column 1';
+    echo 'closing brace at column 5';
+<em>    }</em>
+        ]]>
         </code>
     </code_comparison>
     <standard>
@@ -28,20 +66,16 @@ function foo()
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Closing brace is on a line by itself.">
+        <code title="Valid: Newline before closing brace.">
         <![CDATA[
-function foo()
-{
-    echo 'hi';
+enum Foo {
 <em>}</em>
-]]>
+        ]]>
         </code>
-        <code title="Invalid: Closing brace is alongside other content.">
+        <code title="Invalid: No newline before closing brace.">
         <![CDATA[
-function foo()
-{
-    echo 'hi';<em>}</em>
-]]>
+enum Foo {<em>}</em>
+        ]]>
         </code>
     </code_comparison>
 </documentation>