Documentation modifications

adas-core.Authentication/Attributes/AuthorizeRolesAttribute.cs

@@ -5,6 +5,14 @@ using Microsoft.AspNetCore.Mvc.Filters;
 
 namespace adas_core.Authentication.Attributes;
 
+/// <summary>
+/// Specifies an authorization filter attribute that restricts access to decorated methods based on a required role of type <see cref="PermissionEnum.RolesType"/>.
+/// Inherits from <see cref="Attribute"/> and implements <see cref="IAuthorizationFilter"/> to participate in the authorization pipeline.
+/// </summary>
+/// <remarks>
+/// Constrained by <see cref="System.AttributeUsageAttribute"/> to <see cref="AttributeTargets.Method"/>, the attribute is configured at construction with the required <paramref name="type"/>.
+/// </remarks>
+/// <!-- aidoc:v1 sig=b5093e9 -->
 [AttributeUsage(AttributeTargets.Method)]
 public class AuthorizeRolesAttribute(PermissionEnum.RolesType type) : Attribute, IAuthorizationFilter
 {