diff --git a/doc/source/_templates/index.html b/doc/source/_templates/index.html
index 2456023..5a56949 100644
--- a/doc/source/_templates/index.html
+++ b/doc/source/_templates/index.html
@@ -37,7 +37,6 @@ CTA format), Fermi/LAT and COMPTEL data. {%endtrans%}</p>
 <li><a class="smalllink" href="{{ pathto("user_manual/getting_started/models") }}">{%trans%}Modelling CTA data{%endtrans%}</a></li> 
 <li><a class="smalllink" href="{{ pathto("user_manual/getting_started/response") }}">{%trans%}CTA response functions{%endtrans%}</a></li> 
 <li><a class="smalllink" href="{{ pathto("user_manual/getting_started/python") }}">{%trans%}Using ctools from Python{%endtrans%}</a></li> 
-<li><a class="smalllink" href="{{ pathto("user_manual/getting_started/faq") }}">{%trans%}Frequently asked questions{%endtrans%}</a></li> 
 </ul>
 
 <h2 style="margin-bottom: 0">{%trans%}Documentation{%endtrans%}</h2>
@@ -45,6 +44,8 @@ CTA format), Fermi/LAT and COMPTEL data. {%endtrans%}</p>
 <ul>
 <li><a class="smalllink" href="{{ pathto("user_manual/index") }}">{%trans%}User Manual{%endtrans%}</a></li> 
 <li><a class="smalllink" href="{{ pathto("reference_manual/index") }}">{%trans%}Reference Manual{%endtrans%}</a></li> 
+<li><a class="smalllink" href="{{ pathto("faq") }}">{%trans%}Frequently asked questions{%endtrans%}</a></li> 
+<li><a class="smalllink" href="{{ pathto("issues") }}">{%trans%}Known issues{%endtrans%}</a></li> 
 <li><a class="smalllink" href="doxygen/index.html">{%trans%}Source code documentation (Doxygen){%endtrans%}</a></li> 
 </ul>
 
diff --git a/doc/source/user_manual/getting_started/faq.rst b/doc/source/faq.rst
index 7058d9e..bd0f626 100644
--- a/doc/source/user_manual/getting_started/faq.rst
+++ b/doc/source/faq.rst
@@ -15,6 +15,7 @@ asked.
 - :ref:`What is the difference between ctools and GammaLib? <faq_ctools_gammalib>`
 - :ref:`Are ctools and GammaLib specific to CTA? <faq_instruments>`
 - :ref:`I want to upgrade ctools, do I have to upgrade GammaLib? <faq_upgrade>`
+- :ref:`Why does my ctool complain about missing parameters? <faq_pars>`
 
 
 .. _faq_ctools_gammalib:
@@ -77,3 +78,21 @@ asked.
   (see the :ref:`download` section for a correspondance of versions).
   We plan however to put the GammaLib interface under change control.
   ctools should then become more independent from GammaLib.
+
+
+.. _faq_pars:
+
+.. topic:: Why does my ctool complain about missing parameters?
+
+  After upgrading to a new ctools version, a ctool may issue the following
+  error
+
+  ``*** ERROR in GApplicationPars::operator[](std::string&): Invalid 
+  argument. Parameter "XXX" has not been found in parameter file.
+  Please specify a valid parameter name.``
+
+  This error may occur if some parameters have been added to a ctool and
+  you still have the old parameter file without that parameter sitting in
+  your pfiles folder. Simply erasing all files in the pfiles folder should
+  fix this problem.
+
diff --git a/doc/source/user_manual/getting_started/index.rst b/doc/source/user_manual/getting_started/index.rst
index f703ede..57b6851 100644
--- a/doc/source/user_manual/getting_started/index.rst
+++ b/doc/source/user_manual/getting_started/index.rst
@@ -9,5 +9,4 @@ Getting started
    models
    response
    python
-   faq