diff --git a/reference/mysql/functions/mysql-affected-rows.xml b/reference/mysql/functions/mysql-affected-rows.xml
index d38dec2..160f8e9 100644
--- a/reference/mysql/functions/mysql-affected-rows.xml
+++ b/reference/mysql/functions/mysql-affected-rows.xml
@@ -18,6 +18,16 @@
   </para>
  </refsect1>
 
+ <refsynopsisdiv role="soft-deprecation-notice">
+  <sidebar>
+   &mysql.alternative.note;
+   <simplelist role="alternatives">
+    <member><function>mysqli_affected_rows</function></member>
+    <member><methodname>PDOStatement::rowCount</methodname></member>
+   </simplelist>
+  </sidebar>
+ </refsynopsisdiv>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -122,16 +132,6 @@ Updated Records: 10
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
-   &mysql.alternative.note;
-   <para>
-    &mysql.alternative.include;
-    <simplelist>
-     <member><function>mysqli_affected_rows</function></member>
-     <member><methodname>PDOStatement::rowCount</methodname></member>
-    </simplelist>
-   </para>
-  </note>
-  <note>
    <title>Transactions</title>
    <para>
     If you are using transactions, you need to call