diff --git a/README.md b/README.md
index 71f4a30..4c8c809 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,9 @@
-This is the code repository containing a reference implementation of
-the Vanadium project API.
+# Vanadium
+
+This repository contains a reference implementation of the [Vanadium] APIs.
+
+Unlike the APIs in https://github.com/vanadium/go.v23, which promises to
+provide [backward compatibility] this repository makes no such promises.
+
+[Vanadium]: https://v.io
+[backward compatibility]: https://godoc.v.io/pkg/v.io/v23