From 8da4bf276a0dbbbdecb100dad7091f5c90b3e986 Mon Sep 17 00:00:00 2001
From: Engincan VESKE <enginveske@gmail.com>
Date: Tue, 18 Jan 2022 10:08:27 +0300
Subject: [PATCH] Add summaries to methods for IPermissionDefinitionContext

---
 .../IPermissionDefinitionContext.cs           | 20 +++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/framework/src/Volo.Abp.Authorization.Abstractions/Volo/Abp/Authorization/Permissions/IPermissionDefinitionContext.cs b/framework/src/Volo.Abp.Authorization.Abstractions/Volo/Abp/Authorization/Permissions/IPermissionDefinitionContext.cs
index 1a6f3680ad..6d1f9a31fd 100644
--- a/framework/src/Volo.Abp.Authorization.Abstractions/Volo/Abp/Authorization/Permissions/IPermissionDefinitionContext.cs
+++ b/framework/src/Volo.Abp.Authorization.Abstractions/Volo/Abp/Authorization/Permissions/IPermissionDefinitionContext.cs
@@ -25,17 +25,33 @@ public interface IPermissionDefinitionContext
     /// </summary>
     /// <param name="name">Name of the group</param>
     /// <returns></returns>
-    [NotNull]
+    [CanBeNull]
     PermissionGroupDefinition GetGroupOrNull(string name);
 
-    [CanBeNull]
+    /// <summary>
+    /// Tries to add a new permission group.
+    /// Throws <see cref="AbpException"/> if there is a group with the name.
+    /// <param name="name">Name of the group</param>
+    /// <param name="displayName">Localized display name of the group</param>
+    /// <param name="multiTenancySide">Select a multi-tenancy side</param>
+    /// </summary>
     PermissionGroupDefinition AddGroup(
         [NotNull] string name,
         ILocalizableString displayName = null,
         MultiTenancySides multiTenancySide = MultiTenancySides.Both);
 
+    /// <summary>
+    /// Tries to remove a permission group.
+    /// Throws <see cref="AbpException"/> if there is not any group with the name.
+    /// <param name="name">Name of the group</param>
+    /// </summary>
     void RemoveGroup(string name);
 
+    /// <summary>
+    /// Tries to get a pre-defined permission group.
+    /// Returns null if can not find the given group.
+    /// <param name="name">Name of the group</param>
+    /// </summary>
     [CanBeNull]
     PermissionDefinition GetPermissionOrNull([NotNull] string name);
 }