diff --git a/reference/strings/functions/md5.xml b/reference/strings/functions/md5.xml
index 7998deb863..d359f4afad 100644
--- a/reference/strings/functions/md5.xml
+++ b/reference/strings/functions/md5.xml
@@ -19,6 +19,15 @@
    MD5 Message-Digest Algorithm</link>, and returns that hash.
   </para>
  </refsect1>
+ 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &note.passwordhashing;
+   <simplelist role="alternatives">
+    <member><function>password_hash</function></member>
+   </simplelist>
+ </refsect1>
+
 
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -72,11 +81,6 @@ if (md5($str) === '1f3870be274f6c49b3e31a0c6728957f') {
    </example>
   </para>
  </refsect1>
- 
-  <refsect1 role="notes">
-  &reftitle.notes;
-  &note.passwordhashing;
- </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/strings/functions/sha1.xml b/reference/strings/functions/sha1.xml
index 816a4fdfb5..111bdc6adb 100644
--- a/reference/strings/functions/sha1.xml
+++ b/reference/strings/functions/sha1.xml
@@ -18,6 +18,14 @@
    <link xlink:href="&url.rfc;3174">US Secure Hash Algorithm 1</link>.
   </simpara>
  </refsect1>
+ 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &note.passwordhashing;
+   <simplelist role="alternatives">
+    <member><function>password_hash</function></member>
+   </simplelist>
+ </refsect1>
 
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -72,11 +80,6 @@ if (sha1($str) === 'd0be2dc421be4fcd0172e5afceea3970e2f3d940') {
    </example>
   </para>
  </refsect1>
- 
- <refsect1 role="notes">
-  &reftitle.notes;
-  &note.passwordhashing;
- </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;