diff --git a/docs/FAQ.xml b/docs/FAQ.xml
index 20cab9509..c4cfc9dad 100755
--- a/docs/FAQ.xml
+++ b/docs/FAQ.xml
@@ -155,6 +155,24 @@
       issues.</ulink>.</para>
     </section>
 
+    <section id="faq34a">
+      <title>(FAQ 34a) I am trying to upgrade to Shorewall 4.4 and I'm getting
+      errors when I try to start Shorewall. Where can I find information about
+      these issues?</title>
+
+      <para><emphasis role="bold">Answer</emphasis>: Please see the <ulink
+      url="upgrade_issues.htm">upgrade issues.</ulink></para>
+    </section>
+
+    <section id="faq34b">
+      <title>(FAQ 34b) I am trying to upgrade to Shorewall 4.4 and I'm seeing
+      warning messages when I try to start Shorewall. Where can I find
+      information about these issues?</title>
+
+      <para><emphasis role="bold">Answer</emphasis>: Please see the <ulink
+      url="upgrade_issues.htm">upgrade issues.</ulink></para>
+    </section>
+
     <section id="faq76">
       <title>(FAQ 76) I just upgraded my Debian (Ubuntu, Kubuntu, ...) system
       and now masquerading doesn't work? What happened?</title>