diff --git a/docs/source/index.rst b/docs/source/index.rst
index da69815b..517aa181 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -20,7 +20,8 @@ functionality of the `MDAnalysis library`_
    about
    makingakit
    add
-
+   troubleshooting
+   
 
 Acknowledgements
 ================
diff --git a/docs/source/troubleshooting.rst b/docs/source/troubleshooting.rst
new file mode 100644
index 00000000..4c809cf0
--- /dev/null
+++ b/docs/source/troubleshooting.rst
@@ -0,0 +1,17 @@
+=================
+ Troubleshooting
+=================
+
+Although we are trying to make :ref:`creating a MDAKit <makingakit>`
+straightforward, things can still go wrong. This page collects recipes
+and notes on how to fix problems with MDAKits.
+
+If you have a problem and you can't find an answer here or in the
+other documentation on this site, please get in touch via `MDAnalysis GitHub
+Discussions`_.
+
+
+.. _`MDAnalysis GitHub Discussions`:
+   https://github.com/MDAnalysis/mdanalysis/discussions
+
+