Remove unnecessary XML documentation and attributes from response DTOs

Author: mm-hsh

source/AAS.TwinEngine.DataEngine/Api/AasRegistry/Responses/ShellDescriptorDto.cs

@@ -7,24 +7,12 @@
 using AasCore.Aas3_1;
 
 namespace AAS.TwinEngine.DataEngine.Api.AasRegistry.Responses;
-
-/// <summary>
-/// Descriptor metadata for one Asset Administration Shell.
-/// </summary>
 public class ShellDescriptorDto
 {
-    /// <summary>
-    /// Human-readable description texts.
-    /// </summary>
     [JsonPropertyName("description")]
-    [Description("Localized description entries for the shell descriptor.")]
     public IList<LangStringTextType>? Description { get; init; }
 
-    /// <summary>
-    /// Human-readable display names.
-    /// </summary>
     [JsonPropertyName("displayName")]
-    [Description("Localized display name entries for the shell descriptor.")]
     public IList<LangStringNameType>? DisplayName { get; init; }
 
     [JsonPropertyName("extensions")]
@@ -43,16 +31,13 @@ public class ShellDescriptorDto
     public IList<EndpointDto>? Endpoints { get; init; }
 
     [JsonPropertyName("globalAssetId")]
-    [Description("Global asset identifier associated with the shell.")]
     [DefaultValue("https://example.com/ids/asset/4711")]
     public string? GlobalAssetId { get; set; }
 
     [JsonPropertyName("idShort")]
     public string? IdShort { get; set; }
 
     [JsonPropertyName("id")]
-    [Description("Global shell identifier.")]
-    [DefaultValue("https://example.com/ids/aas/1170_1160_3052_6568")]
     public string? Id { get; set; }
 
     [JsonPropertyName("specificAssetIds")]

source/AAS.TwinEngine.DataEngine/Api/AasRegistry/Responses/ShellDescriptorsDto.cs

@@ -5,23 +5,12 @@
 
 namespace AAS.TwinEngine.DataEngine.Api.AasRegistry.Responses;
 
-/// <summary>
-/// Paginated response containing shell descriptors.
-/// </summary>
 public class ShellDescriptorsDto
 {
-    /// <summary>
-    /// Cursor metadata for paginated result retrieval.
-    /// </summary>
     [JsonPropertyName("paging_metadata")]
-    [Description("Pagination metadata for shell descriptor retrieval.")]
     public PagingMetaDataDto? PagingMetaData { get; set; }
 
-    /// <summary>
-    /// Shell descriptor list.
-    /// </summary>
     [JsonPropertyName("result")]
-    [Description("List of shell descriptors.")]
     public IList<ShellDescriptorDto>? Result { get; init; }
 }
 

source/AAS.TwinEngine.DataEngine/Api/AasRepository/Responses/ShellsDto.cs

@@ -1,27 +1,15 @@
 using System.Text.Json.Nodes;
 using System.Text.Json.Serialization;
-using System.ComponentModel;
 
 using AAS.TwinEngine.DataEngine.Api.Shared;
 
 namespace AAS.TwinEngine.DataEngine.Api.AasRepository.Responses;
 
-/// <summary>
-/// Paginated response containing Asset Administration Shell documents.
-/// </summary>
 public class ShellsDto
 {
-    /// <summary>
-    /// Cursor metadata for paginated result retrieval.
-    /// </summary>
     [JsonPropertyName("paging_metadata")]
-    [Description("Pagination metadata for shell retrieval.")]
     public PagingMetaDataDto? PagingMetaData { get; set; }
 
-    /// <summary>
-    /// Shell documents in JSON form.
-    /// </summary>
     [JsonPropertyName("result")]
-    [Description("List of AAS JSON documents.")]
     public IList<JsonObject>? Result { get; init; }
 }

source/AAS.TwinEngine.DataEngine/Api/AasRepository/Responses/SubmodelRefDto.cs

@@ -1,28 +1,16 @@
 using System.Text.Json.Serialization;
-using System.ComponentModel;
 
 using AAS.TwinEngine.DataEngine.Api.Shared;
 
 using AasCore.Aas3_1;
 
 namespace AAS.TwinEngine.DataEngine.Api.AasRepository.Responses;
 
-/// <summary>
-/// Paginated response containing submodel references.
-/// </summary>
 public class SubmodelRefDto
 {
-    /// <summary>
-    /// Cursor metadata for paginated result retrieval.
-    /// </summary>
     [JsonPropertyName("paging_metadata")]
-    [Description("Pagination metadata for submodel reference retrieval.")]
     public PagingMetaDataDto? PagingMetaData { get; set; }
 
-    /// <summary>
-    /// Submodel references linked to the selected shell.
-    /// </summary>
     [JsonPropertyName("result")]
-    [Description("List of submodel references.")]
     public IList<IReference>? Result { get; init; }
 }

source/AAS.TwinEngine.DataEngine/Api/Discovery/Responses/ShellsByAssetLinkResponseDto.cs

@@ -1,27 +1,14 @@
-using System.Text.Json.Serialization;
-using System.ComponentModel;
+using System.Text.Json.Serialization;
 
 using AAS.TwinEngine.DataEngine.Api.Shared;
 
 namespace AAS.TwinEngine.DataEngine.Api.Discovery.Responses;
 
-/// <summary>
-/// Discovery result containing matching AAS identifiers.
-/// </summary>
 public class ShellsByAssetLinkResponseDto
 {
-    /// <summary>
-    /// Cursor metadata for paginated result retrieval.
-    /// </summary>
     [JsonPropertyName("paging_metadata")]
-    [Description("Pagination metadata for continued discovery queries.")]
     public PagingMetaDataDto? PagingMetaData { get; set; }
 
-    /// <summary>
-    /// Matching AAS identifiers.
-    /// </summary>
-    /// <example>["https://example.com/ids/aas/1170_1160_3052_6568"]</example>
     [JsonPropertyName("result")]
-    [Description("AAS identifiers matching the submitted asset links.")]
     public IList<string>? Result { get; set; }
 }

source/AAS.TwinEngine.DataEngine/Api/SubmodelRegistry/Responses/SubmodelDescriptorDto.cs

@@ -1,22 +1,14 @@
 using System.Text.Json.Serialization;
-using System.ComponentModel;
 
 using AAS.TwinEngine.DataEngine.Api.Shared;
 
 using AasCore.Aas3_1;
 
 namespace AAS.TwinEngine.DataEngine.Api.SubmodelRegistry.Responses;
 
-/// <summary>
-/// Descriptor metadata for one submodel.
-/// </summary>
 public class SubmodelDescriptorDto
 {
-    /// <summary>
-    /// Human-readable description texts.
-    /// </summary>
     [JsonPropertyName("description")]
-    [Description("Localized description entries for the submodel descriptor.")]
     public IList<LangStringTextType>? Description { get; init; }
 
     [JsonPropertyName("displayName")]
@@ -32,8 +24,6 @@ public class SubmodelDescriptorDto
     public string? IdShort { get; set; }
 
     [JsonPropertyName("id")]
-    [Description("Global submodel identifier.")]
-    [DefaultValue("https://example.com/ids/submodel/1234")]
     public string? Id { get; set; }
 
     [JsonPropertyName("semanticId")]