diff --git a/docs/img/favicon-readme.txt b/docs/img/favicon-readme.txt
new file mode 100644
index 00000000..e6862e2c
--- /dev/null
+++ b/docs/img/favicon-readme.txt
@@ -0,0 +1 @@
+favicon.ico was generated using https://realfavicongenerator.net. favicon_package_v0.16.zip in this folder contains icons and instructions for all sorts of browsers and platforms (incl. mobile variants). However, without modifying the MkDocs theme/template they’re of no use.
\ No newline at end of file
diff --git a/docs/img/favicon.ico b/docs/img/favicon.ico
new file mode 100644
index 00000000..aa1ce494
Binary files /dev/null and b/docs/img/favicon.ico differ
diff --git a/docs/img/favicon.png b/docs/img/favicon.png
deleted file mode 100755
index b77f1400..00000000
Binary files a/docs/img/favicon.png and /dev/null differ
diff --git a/docs/img/favicon_package_v0.16.zip b/docs/img/favicon_package_v0.16.zip
new file mode 100644
index 00000000..4237f568
Binary files /dev/null and b/docs/img/favicon_package_v0.16.zip differ
diff --git a/mkdocs.yml b/mkdocs.yml
index b9c70f28..15ff72de 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -18,8 +18,6 @@ extra_css:
 extra_javascript:
 - js/extra.js
 
-site_favicon: img/favicon.png
-
 pages:
 - Overview: 'index.md'
 - English:
diff --git a/rtd-requirements.txt b/rtd-requirements.txt
new file mode 100644
index 00000000..fa5a659e
--- /dev/null
+++ b/rtd-requirements.txt
@@ -0,0 +1,7 @@
+#################################################################
+# This file is configured in RTD -> Admin -> Advanced Settings! #
+#################################################################
+# RTD - MkDocs integration is broken for
+# - MkDocs >= 0.17 due to in-site search failures: https://github.com/rtfd/readthedocs.org/issues/3174
+# - MkDocs >= 0.16 due to stuck fly-out menu: https://groups.google.com/d/msg/mkdocs/v7AVbeB105w/FIlE_n2-AgAJ
+# mkdocs >= 0.16.3, < 0.17