Apply suggestions from code review and a few other changes

Author: rodrigoprimo

WordPress/Docs/DB/RestrictedFunctionsStandard.xml

@@ -5,47 +5,47 @@
     >
     <standard>
     <![CDATA[
-      Avoid touching the database directly with PHP library functions. Use the $wpdb object and associated functions instead.
+    Avoid touching the database directly with PHP library functions. Use the $wpdb object and associated functions instead.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Invalid: Using MySQLi library to fetch posts">
-        <![CDATA[
-$results = <em>mysqli_query</em>(
-    $mysql,
-    "SELECT * FROM wp_posts LIMIT 5" 
-);
-        ]]>
-        </code>
-        <code title="Valid: Use WordPress functions">
+        <code title="Valid: Using a WordPress function to fetch posts.">
         <![CDATA[
 $results = <em>get_posts()</em>;
         ]]>
         </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Invalid: Using MySQLi library to insert a post">
+        <code title="Invalid: Using the MySQLi library to fetch posts.">
         <![CDATA[
-<em>mysqli_query</em>(
+$results = <em>mysqli_query</em>(
     $mysql,
-    "INSERT INTO wp_posts (post_title)
-    VALUES ('Title')" 
+    "SELECT * FROM wp_posts LIMIT 5"
 );
         ]]>
         </code>
-        <code title="Valid: Use WordPress functions">
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Using WordPress functions to insert a post">
         <![CDATA[
-<em>wp_insert_post</em>( 
+<em>wp_insert_post</em>(
     array( 'post_title' => 'Title' )
 );
 
 // or...
 
 global $wpdb;
-<em>$wpdb->insert</em>( 
+<em>$wpdb->insert</em>(
     "{$wpdb->prefix}_posts",
     array( 'post_title' => 'Title' ),
-    array( '%s' ) 
+    array( '%s' )
+);
+        ]]>
+        </code>
+        <code title="Invalid: Using MySQLi library to insert a post">
+        <![CDATA[
+<em>mysqli_query</em>(
+    $mysql,
+    "INSERT INTO wp_posts (post_title)
+    VALUES ('Title')"
 );
         ]]>
         </code>