Add description child to part element (#374)

This PR is related to issue
#373.
Signed-off-by: Silvio Lucio OLIVA <[email protected]>

Author: silviooliva

doxygen/pack.dxy

@@ -38,7 +38,7 @@ PROJECT_NAME           = "Open-CMSIS-Pack"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = "Version 1.7.54"
+PROJECT_NUMBER         = "Version 1.7.55"
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

doxygen/src/General.txt

@@ -80,6 +80,12 @@ packs) and provides useful tips when creating a pack.
     <th>Version</th>
     <th>Description</th>
   </tr>
+  <tr>
+    <td>1.7.55</td>
+    <td>
+      - add 'description' child to \ref element_part "part" element
+    </td>
+  </tr>
   <tr>
     <td>1.7.54</td>
     <td>

doxygen/src/parts_schema.txt

@@ -11,7 +11,7 @@ Optionally, a part may have a group (Hgroup=) and a sub-group (Hsub=) to add fur
 different cuts of the same part exists, and a variant (Hvariant=). 
 
 A part is therefore identified by a name and a class together with the vendor specified by the pack. 
-A part vendor must ensure that the combination of name, revision, class, variant, group and sub-group is unique and not used by multiple parts.
+A part vendor must ensure that the combination of name, revision, variant, class, group and sub-group is unique and not used by multiple parts.
 
 \b Example
 \code
@@ -21,7 +21,8 @@ A part vendor must ensure that the combination of name, revision, class, variant
   <parts>
 
     <part Hvendor="STMicroelectronics" Hname="STSAFE-A110" Hvariant="STSAFA110DFSPL02" Hclass="Secure MCUs" Hgroup="Authentication">
-      <feature type="Crypto" n="128.256" name="Authentication and security for peripherals and IoT devices from STMicroelectronics"/>
+      <description>Authentication, state-of-the-art security for peripherals and IoT devices</description>
+      <feature type="Crypto" n="128.256" name="Authentication and security"/>
       <book name="Images/STSAFA110DFSPL02_UM.pdf" title="User Manual" public="true"/>
       <book name="Images/STSAFA110DFSPL02_DS.pdf" title="Datasheet" public="true"/>
       <image top="Images/STSAFA110DFSPL02_image.jpg" public="true">
@@ -31,7 +32,8 @@ A part vendor must ensure that the combination of name, revision, class, variant
     </part>
 
     <part Hvendor="STMicroelectronics" Hname="STSAFE-A110" Hvariant="STSAFA110S8SPL02" Hclass="Secure MCUs" Hgroup="Authentication">
-      <feature type="Crypto" n="128.256" name="Authentication and security for peripherals and IoT devices from STMicroelectronics"/>
+      <description>Authentication, state-of-the-art security for peripherals and IoT devices</description>
+      <feature type="Crypto" n="128.256" name="Authentication and security"/>
       <book name="Images/STSAFA110S8SPL02_UM.pdf" title="User Manual" public="true"/>
       <book name="Images/STSAFA110S8SPL02_DS.pdf" title="Datasheet" public="true"/>
       <image top="Images/STSAFA110S8SPL02_image.jpg" public="true">
@@ -148,23 +150,29 @@ This element specifies a part. At least one part element must be specified per p
     <th>Type</th>
     <th>Occurrence</th>
   </tr>
+  <tr>
+    <td>description</td>
+    <td>Brief summary of the part (maximum 256 characters, recommended 128 characters).</td>
+    <td>BriefDescType</td>
+    <td>0..1</td>
+  </tr>
   <tr>
     <td>\ref element_part_feature "feature"</td>
 	<td>Describes the features of the part.</td>
 	<td>DeviceFeatureType</td>
-	<td>0..* </td>
+	<td>0..*</td>
   </tr>
   <tr>
     <td>\ref element_part_book "book"</td>
 	<td>Specifies documents that are relevant for the part.</td>
 	<td>BookType</td>
-	<td>0..* </td>
+	<td>0..*</td>
   </tr>
   <tr>
     <td>\ref element_part_image "image"</td>
 	<td>Specifies the part pictures.</td>
 	<td>ComplexType</td>
-	<td>0..1 </td>
+	<td>0..1</td>
   </tr>
   <tr>
     <td>\ref element_part_environment "environment"</td>

schema/PACK.xsd

@@ -18,13 +18,15 @@
   limitations under the License.
 
 
-  $Date:        05. Nov 2025
-  $Revision:    1.7.54
+  $Date:        07. Nov 2025
+  $Revision:    1.7.55
   $Project: Schema File for Package Description File Format Specification
 
   Package file name convention <vendor>.<name>.<version>.pack
-  SchemaVersion=1.7.54
+  SchemaVersion=1.7.55
 
+  07. Nov 2025: v1.7.55
+   - add 'description' child to "part" element
   05. Nov 2025: v1.7.54
    - align documentation with XSD schema by adding 'Hrevision' description to the "part" element
    - add 'Hrevision' as an optional attribute of the "mountedPart" element
@@ -262,7 +264,7 @@
 
 -->
 
-<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="qualified" version="1.7.54">
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="qualified" version="1.7.55">
 
   <!-- NonNegativeInteger specifies the format in which numbers are represented in hexadecimal or decimal format -->
   <xs:simpleType name="NonNegativeInteger">
@@ -1770,6 +1772,7 @@
 
   <xs:complexType name="PartType">
     <xs:sequence>
+      <xs:element name="description" type="BriefDescType" minOccurs="0" maxOccurs="1"/>
       <xs:element name="feature" type="DeviceFeatureType" minOccurs="0" maxOccurs="unbounded" />
       <xs:element name="book" type="BookType" minOccurs="0" maxOccurs="unbounded" />
       <xs:element name="image" minOccurs="0" maxOccurs="1">