chore: docs updates

Author: jeastham1993

user-management/LICENSE

@@ -6,9 +6,6 @@ The User Management Service manages users. It provides one primary API:
 
 ## Architecture
 
-### Domain Structure
-- **`users/`** - User management domain (`/api/users/v1`)
-
 ### Separation of Concerns
 
 The project follows a ports and adapters architecture style, split down into `Driving` and `Driven` adapters, as well as a `Core` library.
@@ -35,7 +32,7 @@ You can find the full [Open API specification in the docs folder](./docs/api.yam
 ## Features
 
 - Register users
-- OAuth2.0 with password and client credential grant types
+- OIDC authorization code flow (frontend app) and client credentials flow (service->service) 
 - Get and update user accounts
 
 ## Events
@@ -117,6 +114,4 @@ dotnet test
 
 This project enforces high code quality through the use of static analysis tools:
 
-### Built in Static Analyis Tools
-
 .NET has built-in Roslyn analyzers that inspect your C# code for code style and quality issues. To enforce these styles, a [`Directory.build.props`](./Directory.build.props) file is included in the repository root that turns on all static analysis tools.

user-management/NOTICE

@@ -9,6 +9,9 @@
 
 namespace Stickerlandia.UserManagement.Api.Configurations;
 
+/// <summary>
+/// Operation filter to add authorization responses and security requirements to Swagger operations.
+/// </summary>
 internal class AuthorizeOperationFilter
     : IOperationFilter
 {

user-management/README.md

@@ -26,7 +26,7 @@ public static IHostApplicationBuilder AddDocumentationEndpoints(this IHostApplic
             };
         });
 
-// Add API documentation
+        // Add API documentation
         builder.Services.AddSwaggerGen(options =>
         {
             options.SwaggerDoc("v1", new OpenApiInfo { Title = serviceName, Version = "v1" });
@@ -36,6 +36,7 @@ public static IHostApplicationBuilder AddDocumentationEndpoints(this IHostApplic
             var xmlFiles = Directory.GetFiles(AppContext.BaseDirectory, "*.xml");
             foreach (var xmlFile in xmlFiles) options.IncludeXmlComments(xmlFile);
 
+            // This manually removes some types from the auth-gen Swagger definitions that aren't required.
             options.DocumentFilter<RemoveSwaggerDefinitionsFilter>();
             options.AddSecurityDefinition("oauth2", new OpenApiSecurityScheme
             {