diff --git a/docs/_static/custom.css b/docs/_static/custom.css
index cfed7d5cd..495b6eac2 100644
--- a/docs/_static/custom.css
+++ b/docs/_static/custom.css
@@ -94,3 +94,11 @@ progress::-webkit-progress-value {
progress::-webkit-progress-bar {
background: #ffa200;
}
+
+.redirect {
+ font-family: monospace, monospace;
+}
+
+.redirect::before {
+ content: "↷ "
+}
diff --git a/docs/artwork b/docs/artwork
index 353182cac..f6c35b56e 160000
--- a/docs/artwork
+++ b/docs/artwork
@@ -1 +1 @@
-Subproject commit 353182cac33aac42c62168dd4c3246bf9985186f
+Subproject commit f6c35b56eaeb1100731c106bc2aaf9194955a872
diff --git a/docs/index.rst b/docs/index.rst
index b322402ce..f34794fb2 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -92,7 +92,6 @@ Appendix
teaching
acknowledgements
intro/user_types
- r
########################
Code lists from chapters
@@ -116,3 +115,4 @@ Code lists from chapters
:hidden:
usecases/datasets
+ r
\ No newline at end of file
diff --git a/docs/r.rst b/docs/r.rst
index f425ab2b6..5b956fee1 100644
--- a/docs/r.rst
+++ b/docs/r.rst
@@ -1,24 +1,71 @@
Redirection
-----------
+This page exists for redirection purposes only.
-.. raw:: HTML
-
-
-
-
-
-
-
-
+..
+ Include a named paragraph in the page, where the javascript code below will
+ place any message.
+
+.. raw:: html
+
+
+ You will be redirected to your target page in a few seconds.
+
+
+.. figure:: artwork/src/redirection.svg
+
+..
+ use a custom role to identify redirect codes so that a bit of JS can find
+ them again
+
+.. role:: redirect
+ :class: redirect
+
+If you continue to see this page, you've ended up in here accidentally and redirection
+failed -- sorry about this.
+
+**Here are some links that may take you to where you need to go:**
+
+..
+ This defines a mapping of redirect codes to their present URLs
+
+:redirect:`GIN`
+ :ref:`gin`
+:redirect:`HCP-dataset`
+ :ref:`usecase_HCP_dataset`
+:redirect:`reproducible-paper`
+ :ref:`usecase_reproducible_paper`
+
+Alternatively, try searching in the "Quick Search" at the left-hand side, or
+scan the handbook's front page at `handbook.datalad.org `_
+for directions.
+
+..
+ This code replaces the r.html?key part with the final URL, while keeping
+ the rest of URL intact.
+
+.. raw:: html
+
+