diff --git a/docs/website_files/README.md b/docs/website_files/README.md
index bc51c4865e..b5521997d5 100644
--- a/docs/website_files/README.md
+++ b/docs/website_files/README.md
@@ -9,27 +9,18 @@ point to additional JS/CSS in this directory that are added on each page load. I
addition, the `theme` directory contains files that overwrite their counterparts in
each of the default themes included with mdbook.
-Currently we use these files to generate a floating Table of Contents panel. The code for
-which was partially taken from
-[JorelAli/mdBook-pagetoc](https://github.com/JorelAli/mdBook-pagetoc/)
-before being modified such that it scrolls with the content of the page. This is handled
-by the `table-of-contents.js/css` files. The table of contents panel only appears on pages
-that have more than one header, as well as only appearing on desktop-sized monitors.
+Currently we use these files to make a few modifications:
-We remove the navigation arrows which typically appear on the left and right side of the
-screen on desktop as they interfere with the table of contents. This is handled by
-the `remove-nav-buttons.css` file.
+* We stylise the chapter titles in the left sidebar by indenting them
+ slightly so that they are more visually distinguishable from the section headers
+ (the bold titles). This is done through the `indent-section-headers.css` file.
-Finally, we also stylise the chapter titles in the left sidebar by indenting them
-slightly so that they are more visually distinguishable from the section headers
-(the bold titles). This is done through the `indent-section-headers.css` file.
-
-In addition to these modifications, we have added a version picker to the documentation.
-Users can switch between documentations for different versions of Synapse.
-This functionality was implemented through the `version-picker.js` and
-`version-picker.css` files.
+* We add a version picker pertaining to the different documentation versions
+ shipped with each version of Synapse. This functionality was implemented through
+ the `version-picker.js` and `version-picker.css` files, and is currently the only
+ requirement for the custom `theme/`.
More information can be found in mdbook's official documentation for
[injecting page JS/CSS](https://rust-lang.github.io/mdBook/format/config.html)
and
-[customising the default themes](https://rust-lang.github.io/mdBook/format/theme/index.html).
\ No newline at end of file
+[customising the default themes](https://rust-lang.github.io/mdBook/format/theme/index.html).
diff --git a/docs/website_files/theme/index.hbs b/docs/website_files/theme/index.hbs
index 7687f731d7..3126184c9b 100644
--- a/docs/website_files/theme/index.hbs
+++ b/docs/website_files/theme/index.hbs
@@ -1,11 +1,11 @@
-
+
{{ title }}
{{#if is_print }}
-
+
{{/if}}
{{#if base_url}}
@@ -15,60 +15,78 @@
{{> head}}
-
-
+
{{#if favicon_svg}}
-
+
{{/if}}
{{#if favicon_png}}
-
+
{{/if}}
-
-
-
+
+
+
{{#if print_enable}}
-
+
{{/if}}
-
- {{#if copy_fonts}}
-
- {{/if}}
+
-
-
-
+
+
+
{{#each additional_css}}
-
+
{{/each}}
{{#if mathjax_support}}
-
+
{{/if}}
+
+
+
+
+
-
-
-
+