diff --git a/faq/README.md b/faq/README.md
index d0961d3..7e2a441 100644
--- a/faq/README.md
+++ b/faq/README.md
@@ -4,14 +4,24 @@ The following page hosts most frequently asked questions as seen on our [issues]
 
 ## permission issues
 
-https://misp.github.io/MISP/INSTALL.ubuntu1804/#5-set-the-permissions
-fig1
+If you have any permission issues, please [set the permissions](https://misp.github.io/MISP/INSTALL.ubuntu1804/#5-set-the-permissions) to something sane first.
 
 ## Update MISP fails
 
-fig2
+![MISP outdated](./figures/misp-outdated.png)
+
+![MISP Update Yes/No](./figures/update-misp-YN.png)
+
+If you are not on a branch, the update will fail.
+
+![not on branch](./figures/misp-not-on-branch.png)
 
 ### error: pathspec 'app/composer.json' did not match any file(s) known to git
 
 This is not an error and can be ignore. Nothing will be impacted by this.
 
+![pathspec](./figures/misp-pathspec.png)
+
+  <!-- 
+![](./figures/misp-module-system-diag.png)
+  -->
diff --git a/faq/figures/misp-module-system-diag.png b/faq/figures/misp-module-system-diag.png
new file mode 100644
index 0000000..49ad9f2
Binary files /dev/null and b/faq/figures/misp-module-system-diag.png differ
diff --git a/faq/figures/misp-not-on-branch.png b/faq/figures/misp-not-on-branch.png
new file mode 100644
index 0000000..f52bc46
Binary files /dev/null and b/faq/figures/misp-not-on-branch.png differ
diff --git a/faq/figures/misp-outdated.png b/faq/figures/misp-outdated.png
new file mode 100644
index 0000000..d0fb2f4
Binary files /dev/null and b/faq/figures/misp-outdated.png differ
diff --git a/faq/figures/misp-pathspec.png b/faq/figures/misp-pathspec.png
new file mode 100644
index 0000000..918b1e6
Binary files /dev/null and b/faq/figures/misp-pathspec.png differ
diff --git a/faq/figures/update-misp-YN.png b/faq/figures/update-misp-YN.png
new file mode 100644
index 0000000..142cb09
Binary files /dev/null and b/faq/figures/update-misp-YN.png differ