diff --git a/lib/storage/acl.js b/lib/storage/acl.js
index 05df9b36115..2b03ba2de57 100644
--- a/lib/storage/acl.js
+++ b/lib/storage/acl.js
@@ -92,6 +92,8 @@ function Acl(options) {
  *
  * //-
  * // For file ACL operations, you can also specify a `generation` property.
+ * // Here is how you would grant ownership permissions to a user on a specific
+ * // revision of a file.
  * //-
  * myFile.acl.add({
  *   scope: 'user-useremail@example.com',