[Documentation] Squiz: Scope Closing Brace (#353)

* Docs: add documentation for Squiz.WhiteSpace.ScopeClosingBrace

* Docs: improve documentation for Squiz.WhiteSpace.ScopeClosingBrace

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

* Docs: clarify wording and code samples for Squiz.WhiteSpace.ScopeClosingBrace

* Docs: combine code examples in Squiz.WhiteSpace.ScopeClosingBrace

Better illustrates that statements can be indented,
and that their closing braces still should align
with the start of the statement.

* Docs: improve examples for Squiz.WhiteSpace.ScopeClosingBrace

- Reduces wordiness
- Adds an example of too little whitespace

* Docs: add missing emphasis in Squiz.WhiteSpace.ScopeClosingBrace

* Docs: improve code examples for Squiz.WhiteSpace.ScopeClosingBrace

- Combine too little with too much whitespace
- Adjust emphasis on example containing PHP tags
- Change example paragraph to span for better HTML formatting

Author: jaymcp

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

@@ -0,0 +1,59 @@
+<documentation title="Scope Closing Brace">
+    <standard>
+    <![CDATA[
+    Indentation of a closing brace must match the indentation of the line containing the opening brace.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Closing brace aligned with line containing opening brace.">
+        <![CDATA[
+function foo()
+{
+<em>}</em>
+
+if (!class_exists('Foo')) {
+    class Foo {
+    <em>}</em>
+<em>}</em>
+
+<?php if ($something) { ?>
+    <span>some output</span>
+<em><?php }</em> ?>
+        ]]>
+        </code>
+        <code title="Invalid: Closing brace misaligned with line containing opening brace.">
+        <![CDATA[
+function foo()
+{
+<em> }</em>
+
+if (!class_exists('Foo')) {
+    class Foo {
+<em>}</em>
+<em>    }</em>
+
+<?php if ($something) { ?>
+    <span>some output</span>
+<em> <?php }</em> ?>
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Closing brace must be on a line by itself.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Close brace on its own line.">
+        <![CDATA[
+enum Foo {
+<em>}</em>
+        ]]>
+        </code>
+        <code title="Invalid: Close brace on a line containing other code.">
+        <![CDATA[
+enum Foo {<em>}</em>
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>