Clearer documentation

Author: r-tome

src/Core/AdminConsole/OrganizationFeatures/OrganizationUsers/SelfRevokeUser/ISelfRevokeOrganizationUserCommand.cs

@@ -10,11 +10,13 @@ public interface ISelfRevokeOrganizationUserCommand
 {
     /// <summary>
     /// Revokes a user from an organization.
-    /// Validates the OrganizationDataOwnership policy is enabled and applies to the user (currently Owners/Admins are exempt),
-    /// the user is a confirmed member, and prevents the last owner from revoking themselves.
     /// </summary>
     /// <param name="organizationId">The organization ID.</param>
     /// <param name="userId">The user ID to revoke.</param>
     /// <returns>A <see cref="CommandResult"/> indicating success or containing an error.</returns>
+    /// <remarks>
+    /// Validates the OrganizationDataOwnership policy is enabled and applies to the user (currently Owners/Admins are exempt),
+    /// the user is a confirmed member, and prevents the last owner from revoking themselves.
+    /// </remarks>
     Task<CommandResult> SelfRevokeUserAsync(Guid organizationId, Guid userId);
 }

src/Core/AdminConsole/OrganizationFeatures/Policies/PolicyRequirements/OrganizationDataOwnershipPolicyRequirement.cs

@@ -91,6 +91,9 @@ public bool IgnoreStorageLimitsOnMigration(Guid organizationId)
     /// </summary>
     /// <param name="organizationId">The organization ID to check.</param>
     /// <returns>True if the user is eligible for self-revocation (policy applies to them), false otherwise.</returns>
+    /// <remarks>
+    /// Self-revoke is used to opt out of migrating the user's personal vault to the organization as required by this policy.
+    /// </remarks>
     public bool EligibleForSelfRevoke(Guid organizationId)
     {
         var policyDetail = _policyDetails