diff --git a/playbooks/roles/gerrit/README.rst b/playbooks/roles/gerrit/README.rst
index 6bd0ea7ae1..a40ee64e0e 100644
--- a/playbooks/roles/gerrit/README.rst
+++ b/playbooks/roles/gerrit/README.rst
@@ -1,7 +1,8 @@
 Run Gerrit.
 
-This role assumes it will have a local MariaDB running adjacent to the
-Gerrit service. Variables below configure MariaDB connection details.
+This role deploys MariaDB alongside the Gerrit service using
+docker-compose to run both services in docker containers.
+Variables below configure MariaDB connection details.
 
 **Role Variables**