diff --git a/doc/schemas/eis-1.0.xsd b/doc/schemas/eis-1.0.xsd
index e1f42c2c7..20499e36d 100644
--- a/doc/schemas/eis-1.0.xsd
+++ b/doc/schemas/eis-1.0.xsd
@@ -7,21 +7,19 @@
 
   <annotation>
     <documentation>
-     EIS Extensible Provisioning Protocol v1.0
-     extension schema.
+     EIS Extensible Provisioning Protocol v1.0 extension schema.
     </documentation>
   </annotation>
 
- <!--
- Child elements found in EPP commands.
- -->
+  <!--
+  Child elements found in EPP commands.
+  -->
 
   <element name="extdata" type="eis:legalDocAndIdentType"/>
 
- <!--
- Child elements supporting either the
- dsData or the keyData interface.
- -->
+  <!--
+  Child elements supporting ident and legal documents.
+  -->
   <complexType name="legalDocAndIdentType">
     <sequence>
       <element name="ident" type="eis:identType" minOccurs="0" maxOccurs="1"/>
@@ -29,9 +27,13 @@
     </sequence>
   </complexType>
 
- <!--
- Child elements of extdata
- -->
+  <!--
+  Child elements of extdata
+  -->
+
+  <!--
+  Legal document, encoded in base64
+  -->
   <complexType name="legalDocType">
     <simpleContent>
       <extension base="base64Binary">
@@ -53,6 +55,9 @@
     </restriction>
   </simpleType>
 
+  <!--
+  Ident with type and country code
+  -->
   <complexType name="identType">
     <simpleContent>
       <extension base="normalizedString">