Documentation modifications

adas-core.Infrastructure/Utils/CustomPointOfCareConverter.cs

@@ -22,6 +22,13 @@ public class CustomPointOfCareConverter : JsonConverter
             return objectType == typeof(PointOfCare);
         }
 
+    /// <summary>
+    /// Serializes an object to JSON, converting all enum-typed properties to their string representation rather than their underlying integer value. If <paramref name="value"/> is <c>null</c>, a JSON null token is written and the method returns immediately.
+    /// </summary>
+    /// <param name="writer">The <see cref="JsonWriter"/> that receives the serialized JSON output.</param>
+    /// <param name="value">The object to serialize. Enum properties on this instance are written as their string names.</param>
+    /// <param name="serializer">The <see cref="JsonSerializer"/> used to convert the value to a <see cref="JObject"/>.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=109184b -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
     {
         if (value == null)
@@ -45,6 +52,16 @@ public class CustomPointOfCareConverter : JsonConverter
         jo.WriteTo(writer);
     }
 
+    /// <summary>
+    /// Reads and deserializes a JSON value into an object of the target <paramref name="objectType"/>. This override is not implemented and serves as a placeholder.
+    /// </summary>
+    /// <param name="reader">The <see cref="JsonReader"/> used to read the incoming JSON tokens.</param>
+    /// <param name="objectType">The <see cref="Type"/> of the object to deserialize into.</param>
+    /// <param name="existingValue">An existing value to reuse during deserialization, or <see langword="null"/> if none is available.</param>
+    /// <param name="serializer">The <see cref="JsonSerializer"/> controlling the deserialization process.</param>
+    /// <returns>An <see cref="object"/> instance populated from the JSON data.</returns>
+    /// <exception cref="NotImplementedException">Thrown in all cases because the method body has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=c91c541 body=bfa6f2f -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
         JsonSerializer serializer)
     {