Extra documentation on the SameAs class

Co-authored-by: Max <maximilian.moser@tuwien.ac.at>

Author: mesemus

invenio_records_permissions/generators.py

@@ -428,6 +428,16 @@ class RecordPermissionPolicy(BasePermissionPolicy):
         same permissions as ``can_edit``. If you later modify ``can_edit`` or override
         it in a subclass, the delegating permissions automatically inherit those changes.
 
+    By virtue of operator overloading, ``SameAs`` can also be used outside of lists
+    to simplify permission policies:
+
+        .. code-block:: python
+
+            class RecordPermissionPolicy(BasePermissionPolicy):
+                can_manage = [RecordOwners(), SystemProcess()]
+                can_curate = SameAs("can_manage") + [AccessGrant("edit")]
+                can_delete = SameAs("can_curate")
+
     Note:
         The permission name must be an attribute on the policy instance and must
         contain a list of generators.