diff --git a/docs/Shorewall-4.xml b/docs/Shorewall-4.xml
index 56ff29278..c74ad1d20 100644
--- a/docs/Shorewall-4.xml
+++ b/docs/Shorewall-4.xml
@@ -100,7 +100,9 @@
     <para>Shorewall 4.4 (currently in Beta testing) discontinues the
     availability of the legacy shell-based compiler. All users must migrate to
     the perl-based compiler before or during an upgrade to Shorewall version
-    4.4</para>
+    4.4. We highly recommend that current users of the shell-based compiler
+    migrate before upgrading to 4.4 so that both compilers are available
+    during the migration.</para>
 
     <para>Shorewall 4.4 contains four packages:</para>