diff --git a/README.md b/README.md
index 9acc0663b..e66e8ae59 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@
-->
# Subspace Library
+
+
An [experimental take](https://danakj.github.io/2022/12/31/why-subspace.html)
on a safer, simpler C++ standard library.
diff --git a/subdoc/README.md b/subdoc/README.md
index a65dab9fa..62f284e0c 100644
--- a/subdoc/README.md
+++ b/subdoc/README.md
@@ -1,5 +1,7 @@
# Subdoc
+
+
[Subdoc](subdoc/) is a documentation generator from inline C++ documentation
in the spirit of
[Rustdoc](https://doc.rust-lang.org/rustdoc/what-is-rustdoc.html).