title: How to document the structure of XML files
body: <p>When it comes to documenting the structure of XML files...</p>
  
  <p>One of my co-workers does it in a Word table.  </p>
  
  <p>Another pastes the elements into a Word document with comments like this:</p>
  
  <pre><code>&lt;learningobject id="{Learning Object Id (same value as the loid tag)}" 
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                  xsi:noNamespaceSchemaLocation="http://www.aicpcu.org/schemas/cms_lo.xsd"&gt;
  
  
  
  
  &lt;objectRoot&gt;
      &lt;v&gt;
          &lt;!-- Current version of the object from the repository. !--&gt;
          &lt;!-- (Occurance: 1) --&gt;
      &lt;/v&gt;
      &lt;label&gt;
          &lt;!-- Name of the object from the repository. !--&gt;
          &lt;!-- (Occurance: 0 or 1 or Many) --&gt;
      &lt;/label&gt;
  &lt;/objectRoot&gt;
  </code></pre>
  
  <p>Which one of these methods is preferred? Is there a better way?</p>
  
  <p>Are there other options that do not require third party Schema Documenter tools to update?</p>