Documentation modifications

adas-core.Authentication/Attributes/PermissionAuthorizeAttribute.cs

@@ -9,6 +9,14 @@ using Microsoft.Extensions.DependencyInjection;
 
 namespace adas_core.Authentication.Attributes;
 
+/// <summary>
+/// Represents an authorization attribute that evaluates permissions using a configured source and an optional resource identifier header.
+/// </summary>
+/// <remarks>
+/// Extends <see cref="AuthorizeAttribute"/> and implements <see cref="IAsyncAuthorizationFilter"/> to support asynchronous authorization filtering.
+/// The primary constructor parameter <paramref name="source"/> specifies the permission source, while the optional <paramref name="resourceIdHeader"/> identifies the header that carries the resource identifier.
+/// </remarks>
+/// <!-- aidoc:v1 sig=e97022a -->
 public class PermissionAuthorizeAttribute(string source, string? resourceIdHeader = null)
     : AuthorizeAttribute, IAsyncAuthorizationFilter
 {