diff --git a/docs/readme.md b/docs/readme.md
index c093809e..188d158b 100644
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -2,6 +2,7 @@
 
 `ndc-postgres` is a [Hasura](https://hasura.io/) connector for PostgreSQL.
 
+- [Usage](./usage/index.md)
 - [Architecture](./architecture.md)
 - [Code of Conduct](./code-of-conduct.md)
 - [Debugging](./debugging.md)