From 6aec3211d170d687b2eb078c11d7b91c2d314b39 Mon Sep 17 00:00:00 2001
From: oltho <oltho@10.171.131.59>
Date: Fri, 20 Sep 2019 16:17:21 +0200
Subject: [PATCH 1/2] Documentation Class Instantiation

---
 .../Classes/ClassInstantiationStandard.xml    | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 WordPress/Docs/Classes/ClassInstantiationStandard.xml

diff --git a/WordPress/Docs/Classes/ClassInstantiationStandard.xml b/WordPress/Docs/Classes/ClassInstantiationStandard.xml
new file mode 100644
index 0000000000..b25fd34ce7
--- /dev/null
+++ b/WordPress/Docs/Classes/ClassInstantiationStandard.xml
@@ -0,0 +1,53 @@
+<documentation title="Class Instantiation">
+    <standard>
+    <![CDATA[
+    Instantiation of an object should be done with parenthesis.  
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: with parenthesis.">
+        <![CDATA[
+$a = new Foobar<em>()</em>;
+        ]]>
+        </code>
+        <code title="Invalid: without parenthesis.">
+        <![CDATA[
+$a = new Foobar;
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Don't use spaces between object name and open parenthesis when instantiating new object.  
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: no spaces between object name and parenthesis.">
+        <![CDATA[
+$a = new Foobar();
+        ]]>
+        </code>
+        <code title="Invalid: spaces between object name and parenthesis.">
+        <![CDATA[
+$a = new Foobar<em> </em>();
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Object instantiation by reference is not supported by PHP anymore.  
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: object instantiation without reference.">
+        <![CDATA[
+$a = new Foobar();
+        ]]>
+        </code>
+        <code title="Invalid: object instantiation by reference.">
+        <![CDATA[
+$a = <em>&</em> new Foobar();
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From aecdaa763576c785779ecb214067436dbba3900b Mon Sep 17 00:00:00 2001
From: oltho <oltho@DESKTOP-6N4561P>
Date: Sat, 28 Sep 2019 01:36:17 +0200
Subject: [PATCH 2/2] Proccessed feedback from jrfnl

---
 .../Docs/Classes/ClassInstantiationStandard.xml    | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/WordPress/Docs/Classes/ClassInstantiationStandard.xml b/WordPress/Docs/Classes/ClassInstantiationStandard.xml
index b25fd34ce7..cdd749ecdd 100644
--- a/WordPress/Docs/Classes/ClassInstantiationStandard.xml
+++ b/WordPress/Docs/Classes/ClassInstantiationStandard.xml
@@ -1,7 +1,7 @@
 <documentation title="Class Instantiation">
     <standard>
     <![CDATA[
-    Instantiation of an object should be done with parenthesis.  
+    Instantiation of an object should be done with parenthesis.
     ]]>
     </standard>
     <code_comparison>
@@ -18,16 +18,16 @@ $a = new Foobar;
     </code_comparison>
     <standard>
     <![CDATA[
-    Don't use spaces between object name and open parenthesis when instantiating new object.  
+    Don't use spaces between the object name and the open parenthesis when instantiating new object.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: no spaces between object name and parenthesis.">
+        <code title="Valid: no whitespace between the object name and the parenthesis.">
         <![CDATA[
 $a = new Foobar();
         ]]>
         </code>
-        <code title="Invalid: spaces between object name and parenthesis.">
+        <code title="Invalid: a space between the object name and the parenthesis.">
         <![CDATA[
 $a = new Foobar<em> </em>();
         ]]>
@@ -35,18 +35,18 @@ $a = new Foobar<em> </em>();
     </code_comparison>
     <standard>
     <![CDATA[
-    Object instantiation by reference is not supported by PHP anymore.  
+    Assigning the return value of "new" by reference was deprecated in PHP 5.3 and removed in PHP 7.0. New by reference should no longer be used.
     ]]>
     </standard>
     <code_comparison>
         <code title="Valid: object instantiation without reference.">
         <![CDATA[
-$a = new Foobar();
+$a = <em>new</em> Foobar();
         ]]>
         </code>
         <code title="Invalid: object instantiation by reference.">
         <![CDATA[
-$a = <em>&</em> new Foobar();
+$a = <em>& new</em> Foobar();
         ]]>
         </code>
     </code_comparison>