Enhance XSD documentation relating to CCMM-controlled vocabularies

[dmiksik]

When working with user groups building their repositories as instances of NRP core repo systems with the internal metadata scheme being an extension of CCMM, we are finding out that it would be helpful to include specific information on the CCMM-controlled vocabularies directly in the XSDs, something along these lines:

AgentRole, AlternateTitle, DescriptionType, RelationType

<xs:complexType name="resource_agent_role_type"
                sawsdl:modelReference="http://www.w3.org/2004/02/skos/core#Concept">
  <xs:annotation>
    <xs:documentation xml:lang="en">
      Role of the agent in relationship to the resource.
      CV: Controlled vocabulary term (SKOS Concept IRI)
      Controlled vocabulary: AgentRole
      Concept scheme IRI: https://vocabs.ccmm.cz/registry/codelist/AgentRole/
      Browse (UI): https://vocabs.ccmm.cz/AgentRole/en/
      Source (CSV): https://raw.githubusercontent.com/techlib/CCMM-controlled-vocab/refs/heads/main/AgentRole.csv
      Example: https://vocabs.ccmm.cz/registry/codelist/AgentRole/Contributor/ContactPerson
    </xs:documentation>
  </xs:annotation>

  <xs:sequence>
    <xs:element name="iri" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation xml:lang="en">
          CV: IRI of a concept from AgentRole concept scheme.
        </xs:documentation>
      </xs:annotation>
    </xs:element>

    <!-- label, any... beze změny -->
  </xs:sequence>
</xs:complexType>

TimeReference, SubjectCategory

<xs:element minOccurs="0" name="iri" type="xs:anyURI">
  <xs:annotation>
    <xs:documentation xml:lang="en">
      CV: Controlled vocabulary concept IRI
      Controlled vocabulary: TimeReference
      Concept scheme IRI: https://vocabs.ccmm.cz/registry/codelist/TimeReference/
      Browse (UI): https://vocabs.ccmm.cz/TimeReference/en/
      Source (CSV): https://raw.githubusercontent.com/techlib/CCMM-controlled-vocab/refs/heads/main/TimeReference.csv
    </xs:documentation>
  </xs:annotation>
</xs:element>

[Wyvi]

We discussed this with the Dataspecer developers. They plan to address this by enabling propagation of usage notes into generated XSDs.