diff --git a/repository/src/main/resources/xsd/repositorytypes.xsd b/repository/src/main/resources/xsd/repositorytypes.xsd
index 758e034..f2a8be4 100644
--- a/repository/src/main/resources/xsd/repositorytypes.xsd
+++ b/repository/src/main/resources/xsd/repositorytypes.xsd
@@ -826,14 +826,41 @@
 		</xs:annotation>
 		<xs:restriction base="xs:string">
 			<xs:enumeration value="SYNOPSIS"/>
+				<xs:annotation>
+					<xs:documentation>
+						Brief summary of the element, typically highlighting its key function or purpose, restricted to one paragraph for conciseness.</xs:documentation>
+				</xs:annotation>
 			<xs:enumeration value="ELABORATION"/>
+				<xs:annotation>
+					<xs:documentation>
+						Detailed explanation of the element, clarifying its usage, functionality, or background.</xs:documentation>
+				</xs:annotation>
 			<xs:enumeration value="EXAMPLE"/>
+				<xs:annotation>
+					<xs:documentation>
+						Sample or illustration demonstrating how the element is used in practice.</xs:documentation>
+				</xs:annotation>
 			<xs:enumeration value="DISPLAY">
 				<xs:annotation>
-					<xs:documentation>For UI when different from canonical name; may
-						have multi-language displays
+					<xs:documentation>
+						For UI when different from canonical name; may have multi-language displays.</xs:documentation>
+				</xs:annotation>
+			<xs:enumeration value="CAPTION">
+				<xs:annotation>
+					<xs:documentation>
+						Descriptive label or title for the element, may be used for tables, figures, headings or brief annotations.</xs:documentation>
+				</xs:annotation>
+			<xs:enumeration value="TOOLTIP">
+				<xs:annotation>
+					<xs:documentation>
+						Short message or hint that appears when hovering over the element, usually explaining its function or use.</xs:documentation>
 					</xs:documentation>
 				</xs:annotation>
+			<xs:enumeration value="DEFINITION">
+				<xs:annotation>
+					<xs:documentation>
+						Precise and formal explanation of the element, restricted to one sentence in length to ensure brevity.</xs:documentation>
+				</xs:annotation>
 			</xs:enumeration>
 		</xs:restriction>
 	</xs:simpleType>