docs: def remove_permission(payload, permission):
      """Remove all occurrences of ``permission`` from ``payload``."""
      payload = copy.deepcopy(payload)
  
      for entity_type in ['users', 'groups']:
          for perm_type in ['add', 'remove']:
              for perms in payload.get(entity_type, {}).get(perm_type, {}).values():
                  if permission in perms:
                      perms.remove(permission)
  
      for perm_type in ['add', 'remove']:
          perms = payload.get('public', {}).get(perm_type, [])
          if permission in perms:
              perms.remove(permission)
  
      return payload