diff --git a/documentation/migration-guides/migration-3.4.rst b/documentation/migration-guides/migration-3.4.rst
index dead6bc66a..c22ea814d6 100644
--- a/documentation/migration-guides/migration-3.4.rst
+++ b/documentation/migration-guides/migration-3.4.rst
@@ -270,6 +270,8 @@ Miscellaneous
   It was being implemented using a custom patch to the ``shadow`` recipe
   which clashed with a ``-P`` option that was added upstream in
   ``shadow`` version 4.9, and in any case is fundamentally insecure.
+  Hardcoded passwords are still supported but they need to be hashed, see
+  examples in :term:`EXTRA_USERS_PARAMS`.
 
 
 .. include:: release-notes-3.4.rst