diff --git a/docs/index.html b/docs/index.html
index 3ca392a..e9192bb 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -99,7 +99,10 @@
 <header>
 <h1>Hell: Shell scripting Haskell dialect</h1>
 
-<nav><a href="api">API documentation</a> | <a href="examples">Examples</a> | <a href="https://github.com/chrisdone/hell/releases">Releases</a></nav>
+<nav><a href="api">API documentation</a>
+  | <a href="examples">Examples</a>
+  | <a href="https://github.com/chrisdone/hell/releases">Releases</a>
+  | <a href="https://chrisdone.com/posts/tour-of-hell/">Design</a></nav>
 </header>
 <p>Hell is a shell
 scripting language that is a tiny dialect of Haskell that I wrote for my
diff --git a/docs/readme.md b/docs/readme.md
index ca1becb..69bae2c 100644
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -2,4 +2,7 @@
 
 Hell is a shell scripting language that is a tiny dialect of Haskell.
 
-[Homepage here.](https://chrisdone.github.io/hell/)
+[Homepage](https://chrisdone.github.io/hell/)
+
+See [Tour of Hell](https://chrisdone.com/posts/tour-of-hell/) for a
+tour of the compiler's implementation.