diff --git a/source/conf.py b/source/conf.py
index 32064a3d..1e103692 100755
--- a/source/conf.py
+++ b/source/conf.py
@@ -21,6 +21,16 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 sys.path.insert(0, os.path.abspath('.'))
 
+# ---- inserted according to read-the-docs announcement on deprecating build time changes ---
+# Define the canonical URL if you are using a custom domain on Read the Docs
+html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "")
+
+# Tell Jinja2 templates the build is running on Read the Docs
+if os.environ.get("READTHEDOCS", "") == "True":
+    html_context["READTHEDOCS"] = True
+    
+# ---- end ---
+
 # > Sphinx v1.6.1
 def setup(app):
   # app.add_stylesheet("theme_overrides.css")