diff --git a/doc/source/_extra/.htaccess b/doc/source/_extra/.htaccess
new file mode 100644
index 0000000000..2459e717f7
--- /dev/null
+++ b/doc/source/_extra/.htaccess
@@ -0,0 +1,3 @@
+# The top-level docs project will redirect URLs from the old /developer docs
+# to their equivalent pages on the new docs.openstack.org only if this file
+# exists.
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 0aa4b3732c..b12725136a 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -182,6 +182,10 @@ html_theme_options = {"sidebar_mode": "toc"}
 # so a file named "default.css" will overwrite the builtin "default.css".
 # html_static_path = ['_static']
 
+# Add any paths that contain "extra" files, such as .htaccess or
+# robots.txt.
+html_extra_path = ['_extra']
+
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
 # html_last_updated_fmt = '%b %d, %Y'