diff --git a/terraform/aws/bucket-access.tf b/terraform/aws/bucket-access.tf
index a9b17b8791..85d914619e 100644
--- a/terraform/aws/bucket-access.tf
+++ b/terraform/aws/bucket-access.tf
@@ -80,6 +80,11 @@ locals {
     `local.bucket_role_actions` to a dictionary with one key per bucket with
     associated permissions.
 
+    Below is an example value `local.bucket_role_actions_lists` could take. This
+    example value is aligned with the example value for
+    `var.hub_cloud_permissions` and `local.bucket_role_actions` in the code
+    block above.
+
     bucket_role_actions_lists:
       scratch-staging:
         - bucket: scratch-staging