diff --git a/share/doc/xsd/host.xsd b/share/doc/xsd/host.xsd
index 89b5084505..211b316ae6 100644
--- a/share/doc/xsd/host.xsd
+++ b/share/doc/xsd/host.xsd
@@ -31,7 +31,9 @@
               <xs:element name="CPU_USAGE" type="xs:integer"/>
               <!-- ^^ Percentage, Usage of CPU calculated by ONE as the summatory CPU requested by all VMs running in the host   -->
               <xs:element name="TOTAL_MEM" type="xs:integer"/>
+              <!-- ^^ Maximum memory that could be used for VMs -->
               <xs:element name="TOTAL_CPU" type="xs:integer"/>
+              <!-- ^^ Number of CPU’s multiplied by 100. For example, a 16 cores machine will have a value of 1600 -->
               <xs:element name="MAX_DISK" type="xs:integer"/>
               <xs:element name="MAX_MEM" type="xs:integer"/>
               <!-- ^^ KB, Total memory in the host   -->