diff --git a/roles/glance/README.md b/roles/glance/README.md
index 70fcbeef91..98b39d40e3 100644
--- a/roles/glance/README.md
+++ b/roles/glance/README.md
@@ -1 +1,6 @@
 # `glance`
+
+This role deploys the OpenStack Image service using the vendored Glance Helm
+chart. It also configures the service endpoints and image storage integration.
+Configured images are imported after the service becomes available.
+Image definitions are supplied through the `glance_images` role variable.