<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" 
    xmlns:xi="http://www.w3.org/2001/XInclude">

  <xs:include schemaLocation="common.xsd"/>
  
  <xs:annotation>
    <xs:documentation>
      metaphor - a system of names for the objects that everyone can relate to 
                 without having specific, hard to earn knowledge about the system
    </xs:documentation>
  </xs:annotation>
  <xs:element name="metaphor">
    <xs:complexType>
      <xs:sequence>
        <xs:annotation>
          <xs:documentation>
            name        - short identification of the metaphor
            description - longer explanation of the metaphor 
            glossary    - collection of often used terms and their meanings
          </xs:documentation>
        </xs:annotation>
        <xs:element name="name" type="name"/>
        <xs:element name="description" type="description"/>
        <xs:element name="glossary">
          <xs:complexType>
            <xs:annotation>
              <xs:documentation>
                term        - a word or group of words designating something
                description - explanation of what the term means
              </xs:documentation>
            </xs:annotation>
            <xs:sequence minOccurs="0" maxOccurs="unbounded">
              <xs:element name="term" type="name"/>
              <xs:element name="description" type="description"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

</xs:schema>
