diff --git a/docs/appendices/compatibility.txt b/docs/appendices/compatibility.rst
similarity index 100%
rename from docs/appendices/compatibility.txt
rename to docs/appendices/compatibility.rst
diff --git a/docs/appendices/data-types.txt b/docs/appendices/data-types.rst
similarity index 100%
rename from docs/appendices/data-types.txt
rename to docs/appendices/data-types.rst
diff --git a/docs/appendices/index.txt b/docs/appendices/index.rst
similarity index 100%
rename from docs/appendices/index.txt
rename to docs/appendices/index.rst
diff --git a/docs/blobs.txt b/docs/blobs.rst
similarity index 100%
rename from docs/blobs.txt
rename to docs/blobs.rst
diff --git a/docs/conf.py b/docs/conf.py
index 64b75e24..11d47f7d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,8 +1,4 @@
-from crate.theme.rtd.conf.crate_python import *
-html_favicon = None
-
-site_url = 'https://crate.io/docs/clients/python/en/latest/'
-extensions = ['sphinx_sitemap']
+from crate.theme.rtd.conf.python import *
 
 rst_prolog = """
 .. |nbsp| unicode:: 0xA0
diff --git a/docs/connect.txt b/docs/connect.rst
similarity index 100%
rename from docs/connect.txt
rename to docs/connect.rst
diff --git a/docs/getting-started.txt b/docs/getting-started.rst
similarity index 100%
rename from docs/getting-started.txt
rename to docs/getting-started.rst
diff --git a/docs/index.txt b/docs/index.rst
similarity index 100%
rename from docs/index.txt
rename to docs/index.rst
diff --git a/docs/query.txt b/docs/query.rst
similarity index 100%
rename from docs/query.txt
rename to docs/query.rst
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 88ebe35e..ced14fe9 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,14 +1 @@
-# don't pin crate version numbers so the latest will always be pulled when you
-# set up your environment from scratch
-
 crate-docs-theme
-
-# packages for local dev
-
-sphinx-autobuild==0.6.0
-
-# the next section should mirror the RTD environment
-
-alabaster>=0.7,<0.8,!=0.7.5
-setuptools<41
-sphinx==1.7.4
diff --git a/docs/sqlalchemy.txt b/docs/sqlalchemy.rst
similarity index 100%
rename from docs/sqlalchemy.txt
rename to docs/sqlalchemy.rst