From 879d68eec6533d2c80324a51eb951535353e4397 Mon Sep 17 00:00:00 2001
From: Rick van Dam <rick-van-dam@outlook.com>
Date: Thu, 9 May 2024 20:44:30 +0200
Subject: [PATCH] add more xml docs and examples

---
 .run/CleanAspCore.run.xml                     |  1 -
 .../Employees/Endpoints/AddEmployee.cs        |  3 ++
 .../Employees/Endpoints/GetEmployeeById.cs    | 36 +++++++++++++++++--
 3 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/.run/CleanAspCore.run.xml b/.run/CleanAspCore.run.xml
index e5a68fc..fd5790c 100644
--- a/.run/CleanAspCore.run.xml
+++ b/.run/CleanAspCore.run.xml
@@ -12,7 +12,6 @@
     <option name="ADDITIONAL_IIS_EXPRESS_ARGUMENTS" value="" />
     <method v="2">
       <option name="Build" default="false" projectName="CleanAspCore" projectPath="$PROJECT_DIR$/CleanAspCore/CleanAspCore.csproj" />
-      <option name="RunConfigurationTask" enabled="true" run_configuration_name="Run db" run_configuration_type="docker-deploy" />
     </method>
   </configuration>
 </component>
\ No newline at end of file
diff --git a/CleanAspCore/Features/Employees/Endpoints/AddEmployee.cs b/CleanAspCore/Features/Employees/Endpoints/AddEmployee.cs
index fa3f26c..940fa64 100644
--- a/CleanAspCore/Features/Employees/Endpoints/AddEmployee.cs
+++ b/CleanAspCore/Features/Employees/Endpoints/AddEmployee.cs
@@ -13,11 +13,13 @@ public sealed class CreateEmployeeRequest
     /// <summary>
     /// The firstname of this employee.
     /// </summary>
+    /// <example>Mary</example>
     public required string FirstName { get; init; }
 
     /// <summary>
     /// The lastname of this employee.
     /// </summary>
+    /// <example>Poppins</example>
     public required string LastName { get; init; }
 
     /// <summary>
@@ -28,6 +30,7 @@ public sealed class CreateEmployeeRequest
     /// <summary>
     /// The gender of this employee.
     /// </summary>
+    /// <example>Female</example>
     public required string Gender { get; init; }
 
     /// <summary>
diff --git a/CleanAspCore/Features/Employees/Endpoints/GetEmployeeById.cs b/CleanAspCore/Features/Employees/Endpoints/GetEmployeeById.cs
index ac1583f..49b1237 100644
--- a/CleanAspCore/Features/Employees/Endpoints/GetEmployeeById.cs
+++ b/CleanAspCore/Features/Employees/Endpoints/GetEmployeeById.cs
@@ -6,28 +6,58 @@
 namespace CleanAspCore.Features.Employees.Endpoints;
 
 /// <summary>
-/// 
+///
 /// </summary>
 public sealed class GetEmployeeResponse
 {
+    /// <summary>
+    /// The id of this employee.
+    /// </summary>
     public required Guid Id { get; init; }
+
+    /// <summary>
+    /// The firstname of this employee.
+    /// </summary>
+    /// <example>Mary</example>
     public required string FirstName { get; init; }
+
+    /// <summary>
+    /// The lastname of this employee.
+    /// </summary>
+    /// <example>Poppins</example>
     public required string LastName { get; init; }
+
+    /// <summary>
+    /// The email of this employee.
+    /// </summary>
     public required string Email { get; init; }
+
+    /// <summary>
+    /// The gender of this employee.
+    /// </summary>
+    /// <example>Female</example>
     public required string Gender { get; init; }
+
+    /// <summary>
+    /// The department id of which this employee is in.
+    /// </summary>
     public required Guid DepartmentId { get; init; }
+
+    /// <summary>
+    /// The job id of this employee.
+    /// </summary>
     public required Guid JobId { get; init; }
 }
 
 internal static class GetEmployeeById
 {
-    internal static async Task<JsonHttpResult<GetEmployeeResponse>> Handle(Guid id, HrContext context, CancellationToken cancellationToken)
+    internal static async Task<Ok<GetEmployeeResponse>> Handle(Guid id, HrContext context, CancellationToken cancellationToken)
     {
         var result = await context.Employees
             .Where(x => x.Id == id)
             .Select(x => x.ToDto())
             .FirstAsync(cancellationToken);
-        return TypedResults.Json(result);
+        return TypedResults.Ok(result);
     }
 
     private static GetEmployeeResponse ToDto(this Employee employee) => new()