Include Note for the Operation GenerateSerializationByIds (#512)

* add note for the operation GenerateSerializationByIds

* Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc

Co-authored-by: Birgit Boss <[email protected]>

---------

Co-authored-by: Birgit Boss <[email protected]>

Author: sebbader-sap

documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc

@@ -19,7 +19,6 @@ Major Changes:
 
 Minor Changes:
 
-* ...
 * Added the `ServerNotImplemented` status code to the xref:specification/interfaces-payload.adoc#table-status-codes[Status Codes]. Note that the HTTP API mentioned this status code already, therefore, no change in OpenAPI or other related files. (https://github.com/admin-shell-io/aas-specs-api/issues/499[#499])
 
 
@@ -29,9 +28,8 @@ Minor Changes:
 [%autowidth,width="100%",cols="40%,15%,45%",options="header",]
 |===
 h|Operation  h|Kind of Change h|Comment
-
+ | GenerateSerializationByIds|change a| Added a note to clarify the intended behavior for transitively referenced concept descriptions. (https://github.com/admin-shell-io/aas-specs-api/issues/510[#510])
  | PutAssetAdministrationShellById|change a| Added the missing `id` input parameter and a note explaining the behavior in case the AAS identifier does not match the value of `id`. (https://github.com/admin-shell-io/aas-specs-api/issues/506[#506])
-
 |===
 
 

documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc

@@ -654,7 +654,12 @@ h|Name h|Description h|Mand. h|Type h|Card.
 5+h|Input Parameter
 |aasIds |The unique ids of the Asset Administration Shells to be contained in the serialization |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1..*
 |submodelIds |The unique ids of the Submodels to be contained in the serialization |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1..*
-|includeConceptDescriptions a|Include all concept descriptions that are referenced in the Submodels contained in the serialization and that are known to the server |no |boolean |1
+|includeConceptDescriptions a|Include all concept descriptions that are referenced in the Submodels contained in the serialization and that are known to the server
+====
+Note: This shall also include the concept descriptions that are indirectly referenced by a Submodel, e.g., via the `valueList` attribute from the  IEC 63260 data specification template.
+====
+
+|no |boolean |1
 |serializationFormat |Denotes in which serialization format the requested content shall be delivered |no |xref:specification/interfaces.adoc#SerializationFormat[SerializationFormat] |1
 5+h|Output Parameter
 |statusCode |Status code |yes |xref:specification/interfaces-payload.adoc#StatusCode[StatusCode] |1