diff --git a/resources/schema/inventory.xsd b/resources/schema/inventory.xsd
index 8a2996d..125b3a6 100644
--- a/resources/schema/inventory.xsd
+++ b/resources/schema/inventory.xsd
@@ -1,17 +1,20 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
-  <xsd:import namespace="http://www.w3.org/XML/1998/namespace"
-              schemaLocation="http://www.w3.org/2001/xml.xsd" />
 
+<!-- This inventory defines types which are intended as building blocks that can and should be used in all CJVT schemas. -->
+<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+  <xsd:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="http://www.w3.org/2001/xml.xsd" />
+
+  <!-- Status string identifying stage in the lexicographic process -->
   <xsd:simpleType name="statusType">
     <xsd:restriction base="xsd:string"/>
   </xsd:simpleType>
 
+  <!-- Basic form and info of a lexical unit -->
   <xsd:complexType name="lemmaType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
-        <xsd:attribute name="audio" type="xsd:string"/>
-        <xsd:attribute name="type">
+        <xsd:attribute name="audio" type="xsd:string"/> <!-- legacy ID associated with an audio file -->
+        <xsd:attribute name="type"> <!-- one of a limited number of possible types, default interpretation is normally "single" -->
           <xsd:simpleType>
             <xsd:restriction base="xsd:string">
               <xsd:enumeration value="single"/>
@@ -24,16 +27,19 @@
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- Free form comment -->
   <xsd:simpleType name="commentType">
     <xsd:restriction base="xsd:string"/>
   </xsd:simpleType>
 
+  <!-- Used if need to disambiguate between two lexical units with the same lemma -->
   <xsd:complexType name="homonymyType">
     <xsd:sequence>
       <xsd:element name="homonymyFeature" type="homonymyFeatureType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Basic grammatical feature as a name-value pair -->
   <xsd:complexType name="grammarFeatureType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
@@ -42,6 +48,7 @@
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- Lemma-disambiguating feature, more open-ended than grammarFeatureType -->
   <xsd:complexType name="homonymyFeatureType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
@@ -50,6 +57,7 @@
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- Element which uniquely identifies a headword, with its basic properties and (if necessary) disambiguating features -->
   <xsd:complexType name="headwordType">
     <xsd:sequence>
       <xsd:element name="lemma" type="lemmaType"/>
@@ -57,34 +65,36 @@
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Word component of a lexical unit -->
   <xsd:complexType name="lexemeType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
-        <xsd:attribute name="type" type="xsd:string"/>
-        <xsd:attribute name="lexical_unit_lexeme_id" type="xsd:int"/>
-        <xsd:attribute name="sloleks" type="xsd:string"/>
-        <xsd:attribute name="kol" type="xsd:string"/>
+        <xsd:attribute name="type" type="xsd:string"/> <!-- hmm: should probably restrict possible values? currently seems to be "compound" or empty -->
+        <xsd:attribute name="lexical_unit_lexeme_id" type="xsd:int"/> <!-- ID within its lexical unit -->
+        <xsd:attribute name="sloleks" type="xsd:string"/> <!-- Sloleks ID -->
+        <xsd:attribute name="kol" type="xsd:string"/> <!-- hmm, legacy attribute for a collocate's lemma; why not just use @lemma? -->  
         <xsd:attribute name="lemma" type="xsd:string"/>
-        <xsd:attribute name="msd" type="xsd:string"/>
+        <xsd:attribute name="msd" type="xsd:string"/> <!-- msd within the Slovene JOS system -->
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- The lexical unit of the headword -->
   <xsd:complexType name="lexicalUnitType">
     <xsd:sequence>
-      <xsd:choice>
+      <xsd:choice> <!-- the headword can be either a single lexeme or multiple components --> 
         <xsd:element name="lexeme" type="lexemeType"/>
         <xsd:element name="component" type="componentType" minOccurs="2" maxOccurs="unbounded"/>
       </xsd:choice>
     </xsd:sequence>
-    <xsd:attribute name="id" type="xsd:int" use="required"/>
-    <xsd:attribute name="type" type="xsd:string" use="required"/>
-    <xsd:attribute name="structure_id" type="xsd:int"/>
-    <xsd:attribute name="origin" type="xsd:string"/>
+    <xsd:attribute name="id" type="xsd:int" use="required"/> 
+    <xsd:attribute name="type" type="xsd:string" use="required"/> <!-- should probably restrict possible values in line with superbaza lexical_unit_type -->
+    <xsd:attribute name="structure_id" type="xsd:int"/> <!-- syntactic structure ID -->
+    <xsd:attribute name="origin" type="xsd:string"/> <!-- legacy attribute to track where the lexical unit came from -->
   </xsd:complexType>
 
+  <!-- Slovenian morphosyntactic categories (using the JOS system) -->
   <xsd:simpleType name="categoryType">
-    <!-- The closed set of expected categories. -->
     <xsd:restriction base="xsd:string">
       <xsd:enumeration value="samostalnik"/>
       <xsd:enumeration value="glagol"/>
@@ -101,28 +111,32 @@
     </xsd:restriction>
   </xsd:simpleType>
 
+  <!-- Grammatical information -->
   <xsd:complexType name="grammarType">
     <xsd:sequence>
-      <xsd:element name="category" type="categoryType" minOccurs="0"/>
-      <xsd:element name="grammarFeature" type="grammarFeatureType" minOccurs="0" maxOccurs="unbounded"/>
+      <xsd:element name="category" type="categoryType" minOccurs="0"/> <!-- identifies the part of speech, unless it's not a single lexeme -->
+      <xsd:element name="grammarFeature" type="grammarFeatureType" minOccurs="0" maxOccurs="unbounded"/> <!-- relevant grammatical features -->
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Statistical measure -->
   <xsd:complexType name="measureType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:decimal">
-        <xsd:attribute name="type" type="xsd:string" use="required"/>
-        <xsd:attribute name="source" type="xsd:string"/>
+        <xsd:attribute name="type" type="xsd:string" use="required"/> <!-- type of measure (e.g., frequency, logDice) -->
+        <xsd:attribute name="source" type="xsd:string"/> <!-- context of the measure, probably corpus name and version -->
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
     
+  <!-- List of measures -->
   <xsd:complexType name="measureListType">
     <xsd:sequence>
       <xsd:element name="measure" type="measureType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Variant of a lexical unit -->
   <xsd:complexType name="variantType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
@@ -131,123 +145,136 @@
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- List of variants -->
   <xsd:complexType name="variantListType">
     <xsd:sequence>
       <xsd:element name="variant" type="variantType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Related lexical unit -->
   <xsd:complexType name="relatedEntryType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
         <xsd:attribute name="lexical_unit_id" type="xsd:int"/>
-        <xsd:attribute name="origin" type="xsd:string"/>
+        <xsd:attribute name="origin" type="xsd:string"/> <!-- legacy attribute to track where the lexical unit came from -->
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
     
+  <!-- List of related entries -->
   <xsd:complexType name="relatedEntryListType">
     <xsd:sequence>
       <xsd:element name="relatedEntry" type="relatedEntryType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Name-value pair for providing extra information -->
   <xsd:complexType name="labelType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
         <xsd:attribute name="feature_id" type="xsd:int"/>
-        <xsd:attribute name="featureId" type="xsd:string"/>
-        <xsd:attribute name="type" type="xsd:string"/>
+        <xsd:attribute name="featureId" type="xsd:string"/> <!-- an ID from an external source of the label feature -->
+        <xsd:attribute name="type" type="xsd:string"/> <!-- name of the label feature corresponding to its ID -->
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- List of labels -->
   <xsd:complexType name="labelListType">
     <xsd:sequence>
       <xsd:element name="label" type="labelType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Definition of a sense -->
   <xsd:complexType name="definitionType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
-        <xsd:attribute name="type" type="xsd:string"/>
+        <xsd:attribute name="type" type="xsd:string"/> <!-- hmm: what's expected here? -->
         <xsd:attribute name="definition_id" type="xsd:int"/>
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
     
+  <!-- List of definitions -->
   <xsd:complexType name="definitionListType">
     <xsd:sequence>
       <xsd:element name="definition" type="definitionType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Translation from Slovene into another language -->   
   <xsd:complexType name="translationType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
-        <xsd:attribute name="targetLang" type="xsd:string" use="required"/>
-        <xsd:attribute name="source" type="xsd:string"/>
-        <xsd:attribute name="audio" type="xsd:string"/>
+        <xsd:attribute name="targetLang" type="xsd:string" use="required"/> <!-- target language --> 
+        <xsd:attribute name="source" type="xsd:string"/> <!-- where the translation comes from -->
+        <xsd:attribute name="audio" type="xsd:string"/> <!-- legacy ID associated with an audio file --> 
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- Component of a syntactic structure, containing one of the lexemes of a lexical unit; used in non-mixed content contexts -->
   <xsd:complexType name="componentType">
     <xsd:sequence>
       <xsd:element name="lexeme" type="lexemeType"/>
     </xsd:sequence>
     <xsd:attribute name="structure_id" type="xsd:int"/>
-    <xsd:attribute name="num" type="xsd:int"/>
+    <xsd:attribute name="num" type="xsd:int"/> <!-- index identifying the component's position within the syntactic structure -->
   </xsd:complexType>
 
+  <!-- Component in a syntactic structure and lexeme in a lexical unit; used in mixed content contexts -->
   <xsd:complexType name="compType">
     <xsd:simpleContent>
       <xsd:extension base="xsd:string">
         <xsd:attribute name="structure_id" type="xsd:int"/>
-        <xsd:attribute name="num" type="xsd:int"/>
-        <xsd:attribute name="role">
+        <xsd:attribute name="num" type="xsd:int"/> <!-- index identifying the component's position within the syntactic structure -->
+        <xsd:attribute name="role"> <!-- withinin collocations, identifies the word's role -->
           <xsd:simpleType>
             <xsd:restriction base="xsd:string">
               <xsd:enumeration value="headword"/>
               <xsd:enumeration value="collocate"/>
-              <xsd:enumeration value="other"/>
+              <xsd:enumeration value="other"/> <!-- used for prepositions and other extra components -->
             </xsd:restriction>
           </xsd:simpleType>
         </xsd:attribute>
-        <xsd:attribute name="sloleks" type="xsd:string"/>
-        <xsd:attribute name="kol" type="xsd:string"/>
+        <xsd:attribute name="sloleks" type="xsd:string"/> <!-- Sloleks ID -->
+        <xsd:attribute name="kol" type="xsd:string"/> <!-- legacy attribute for the word's lemma -->
       </xsd:extension>
     </xsd:simpleContent>
   </xsd:complexType>
 
+  <!-- Mixed-content container element used in examples where roles can include multiple word components (e.g., semantic roles).   -->
   <xsd:complexType name="exampleTreeType" mixed="true">
     <xsd:sequence>
-      <xsd:element name="comp" type="compType" maxOccurs="unbounded"/>
+      <xsd:element name="comp" type="compType" maxOccurs="unbounded"/> <!-- the tree contains one or more components -->
     </xsd:sequence>
-    <xsd:attribute name="role" type="xsd:string"/>
+    <xsd:attribute name="role" type="xsd:string"/> <!-- should probably be a valid value from semanticRoleType -->
   </xsd:complexType>
 
+  <!-- Example sentence from a corpus (as opposed to a multi-word example) -->
   <xsd:complexType name="corpusExampleType" mixed="true">
     <xsd:sequence>
-      <xsd:choice minOccurs="0" maxOccurs="unbounded">
+      <xsd:choice minOccurs="0" maxOccurs="unbounded"> <!-- in most contexts, comps are sufficient, but in some trees are needed -->
         <xsd:element name="comp" type="compType"/>
         <xsd:element name="tree" type="exampleTreeType"/>
       </xsd:choice>
     </xsd:sequence>
     <xsd:attribute name="corpus_id" type="xsd:int"/>
     <xsd:attribute name="example_id" type="xsd:int"/>
-    <xsd:attribute name="exampleId" type="xsd:string"/>
-    <xsd:attribute name="modified" type="xsd:boolean"/>
+    <xsd:attribute name="exampleId" type="xsd:string"/> <!-- the example's ID within the corpus itself --> 
+    <xsd:attribute name="modified" type="xsd:boolean"/> <!-- is the example text different than in the corpus? -->
     <xsd:attribute name="lexical_unit_id" type="xsd:int"/>
-    <xsd:attribute name="audio" type="xsd:string"/>
+    <xsd:attribute name="audio" type="xsd:string"/> <!-- legacy ID associated with an audio file --> 
   </xsd:complexType>
 
+  <!-- Multi-word example (as opposed to a corpus sentence) -->
   <xsd:complexType name="multipleLexemeExampleType">
     <xsd:sequence>
-      <xsd:element name="comp" type="compType" maxOccurs="unbounded"/>
+      <xsd:element name="comp" type="compType" maxOccurs="unbounded"/> <!-- the example consists of a sequence of components -->
     </xsd:sequence>
-    <xsd:attribute name="type" use="required">
+    <xsd:attribute name="type" use="required"> <!-- one of a pre-defined set of types (which will probably still be expanded) -->
       <xsd:simpleType>
         <xsd:restriction base="xsd:string">
           <xsd:enumeration value="collocation"/>
@@ -257,32 +284,35 @@
     </xsd:attribute>
     <xsd:attribute name="lexical_unit_id" type="xsd:int"/>
     <xsd:attribute name="structure_id" type="xsd:int"/>
-    <xsd:attribute name="structureName" type="xsd:string"/>
+    <xsd:attribute name="structureName" type="xsd:string"/> <!-- a string name for the structure, especially if we don't have its ID -->
     <xsd:attribute name="frequency" type="xsd:int"/>
     <xsd:attribute name="logDice" type="xsd:decimal"/>
-    <xsd:attribute name="audio" type="xsd:string"/>
-    <xsd:attribute name="cluster" type="xsd:int"/>
+    <xsd:attribute name="audio" type="xsd:string"/> <!-- legacy ID associated with an audio file -->
+    <xsd:attribute name="cluster" type="xsd:int"/> <!-- number identifying a group of clustered examples -->
   </xsd:complexType>
 
+  <!-- Wrapper including a translation and related data -->
   <xsd:complexType name="translationContainerType">
     <xsd:sequence>
       <xsd:element name="labelList" type="labelListType" minOccurs="0"/>
       <xsd:element name="translation" type="translationType"/>
-      <xsd:element name="explanation" type="xsd:string" minOccurs="0"/>
+      <xsd:element name="explanation" type="xsd:string" minOccurs="0"/> <!-- hmm: what's expected here? -->
     </xsd:sequence>
-    <xsd:attribute name="cluster" type="xsd:int" use="optional"/>
-    <xsd:attribute name="source" type="xsd:string" use="optional"/>
+    <xsd:attribute name="cluster" type="xsd:int"/> <!-- number identifying a group of clustered translations -->
+    <xsd:attribute name="source" type="xsd:string"/> <!-- hmm, we already have @source under translationType, that's not enough? -->
   </xsd:complexType>
 
+  <!-- List of translation wrappers -->
   <xsd:complexType name="translationContainerListType">
     <xsd:sequence>
       <xsd:element name="translationContainer" type="translationContainerType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
   
+  <!-- Wrapper including an example and (possibly) its translation -->
   <xsd:complexType name="exampleContainerType">
     <xsd:sequence>
-      <xsd:choice>
+      <xsd:choice> <!-- can be a corpus example or a multi-word example -->
         <xsd:element name="corpusExample" type="corpusExampleType"/>
         <xsd:element name="multiwordExample" type="multipleLexemeExampleType"/>
       </xsd:choice>
@@ -290,12 +320,14 @@
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- List of example containers -->
   <xsd:complexType name="exampleContainerListType">
     <xsd:sequence>
       <xsd:element name="exampleContainer" type="exampleContainerType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Set of semantic role labels -->
   <xsd:simpleType name="semanticRoleType">
     <xsd:restriction base="xsd:string">
       <xsd:enumeration value="ACT"/>
@@ -326,58 +358,66 @@
     </xsd:restriction>
   </xsd:simpleType>
 
+  <!-- Container which associates a set of statistics with a certain type of data -->
   <xsd:complexType name="statisticsContainerType">
     <xsd:sequence>
-      <xsd:choice>
+      <xsd:choice> <!-- currently only semantic roles are supported, but expect other types of data in future --> 
         <xsd:element name="semanticRole" type="semanticRoleType"/>
       </xsd:choice>
       <xsd:element name="measureList" type="measureListType"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- List of statistics containers -->
   <xsd:complexType name="statisticsContainerListType">
     <xsd:sequence>
       <xsd:element name="statisticsContainer" type="statisticsContainerType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Syntactic structure, with its components or examples -->
   <xsd:complexType name="syntacticStructureType">
-    <xsd:sequence>
-      <xsd:choice>
+    <xsd:sequence> 
+      <xsd:choice> <!-- Can either list the structure's components, or examples of the structure (maybe this should be divided into 2 types) -->
         <xsd:element name="component" type="componentType" minOccurs="0" maxOccurs="unbounded"/>
         <xsd:element name="exampleContainerList" type="exampleContainerListType" minOccurs="0" maxOccurs="unbounded"/>
       </xsd:choice>
     </xsd:sequence>
     <xsd:attribute name="id" type="xsd:int"/>
-    <xsd:attribute name="name" type="xsd:string"/>
-    <xsd:attribute name="pp" type="xsd:string"/>
+    <xsd:attribute name="name" type="xsd:string"/> <!-- a string name for the structure, especially if we don't have its ID -->
+    <xsd:attribute name="pp" type="xsd:string"/> <!-- the structure's preposition (if any) -->
   </xsd:complexType>
 
+  <!-- List of syntactic structures -->
   <xsd:complexType name="syntacticStructureListType">
     <xsd:sequence>
       <xsd:element name="syntacticStructure" type="syntacticStructureType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
-    <xsd:attribute name="system" type="xsd:string"/>
+    <xsd:attribute name="system" type="xsd:string"/> <!-- probably JOS or UD -->
   </xsd:complexType>
 
+  <!-- Container associating a semantic role with a list of syntactic structures -->
   <xsd:complexType name="semanticRoleContainerType">
     <xsd:sequence>
       <xsd:element name="semanticRole" type="semanticRoleType"/>
       <xsd:element name="syntacticStructureList" type="syntacticStructureListType"/>
     </xsd:sequence>
-    <xsd:attribute name="cluster" type="xsd:int" use="optional"/>
+    <xsd:attribute name="cluster" type="xsd:int"/>  <!-- hmm, number identifying a group of clustered roles? -->
   </xsd:complexType>
 
+  <!-- List of semantic role containers -->
   <xsd:complexType name="semanticRoleContainerListType">
     <xsd:sequence>
       <xsd:element name="semanticRoleContainer" type="semanticRoleContainerType" minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
   </xsd:complexType>
 
+  <!-- Human-readable string identifying a valency pattern -->
   <xsd:simpleType name="patternRepresentationType">
     <xsd:restriction base="xsd:string"/>
   </xsd:simpleType>
 
+  <!-- Wrapper for valency pattern data -->
   <xsd:complexType name="valencyPatternType">
     <xsd:sequence>
       <xsd:element name="measureList" type="measureListType"/>
@@ -388,6 +428,7 @@
     <xsd:attribute name="id" type="xsd:int"/>
   </xsd:complexType>
       
+  <!-- List of valency patterns -->
   <xsd:complexType name="valencyPatternListType">
     <xsd:sequence>
       <xsd:element name="valencyPattern" type="valencyPatternType" minOccurs="0" maxOccurs="unbounded"/>
diff --git a/resources/schema/top_dictionaries.xsd b/resources/schema/top_dictionaries.xsd
index 9ea7428..493958c 100644
--- a/resources/schema/top_dictionaries.xsd
+++ b/resources/schema/top_dictionaries.xsd
@@ -1,7 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
+<!-- Rudimentary top-down schema intended for all CJVT dictionary-style datasets. Each such dataset should be
+validated both with this schema and with an appropriate more specific schema based on the inventory. -->
 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
-  <xsd:import namespace="http://www.w3.org/XML/1998/namespace"
-              schemaLocation="http://www.w3.org/2001/xml.xsd" />
+  <xsd:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="http://www.w3.org/2001/xml.xsd" />
 
   <!-- top-level element is a dictionary -->
   <xsd:element name="dictionary" type="dictionaryType"/>