diff --git a/doc_src/python_docs_theme/theme.conf b/doc_src/python_docs_theme/theme.conf
index 3d84fcf52..d77003caa 100644
--- a/doc_src/python_docs_theme/theme.conf
+++ b/doc_src/python_docs_theme/theme.conf
@@ -1,3 +1,9 @@
+# This theme is based on the python docs theme, version 2020.1.
+# Changes:
+#
+# - References to python changed to fish references (including the logo)
+# - Styling was adjusted to fit fishshell.com - a gradient border around the main div, plus a shadow, some other backgrond colors and fonts, a border around the sidebar.
+# - The genindex, next/previous and copyright links were removed
 [theme]
 inherit = default
 stylesheet = pydoctheme.css