diff --git a/roles/nova/README.md b/roles/nova/README.md
index 0a4b9dbc40..9b17fa58c3 100644
--- a/roles/nova/README.md
+++ b/roles/nova/README.md
@@ -1 +1,7 @@
 # `nova`
+
+This role deploys the OpenStack Compute service using the vendored Nova Helm
+chart. It configures the API, scheduler, and compute services used by the
+deployment.
+Configured flavors are created after the Compute API becomes available.
+Flavor definitions are supplied through the `nova_flavors` role variable.