Add new Resource > Institution element

clarin-eric · Sep 4, 2024 · 9f364a3 · 9f364a3
1 parent d4af5ee
commit 9f364a3
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 0 deletions.
diff --git a/fcs-core-2.0/attachments/Endpoint-Description.xsd b/fcs-core-2.0/attachments/Endpoint-Description.xsd
@@ -310,6 +310,17 @@
                     </xs:annotation>
                 </xs:element>
 
+                <xs:element name="Institution" type="ed:i18nString" minOccurs="0" maxOccurs="unbounded">
+                    <xs:annotation>
+                        <xs:documentation>
+                            <h:p>
+                                An optional human-readable institution name of the resource.
+                                If supplied, an English version is mandatory.
+                            </h:p>
+                        </xs:documentation>
+                    </xs:annotation>
+                </xs:element>
+
                 <xs:element name="LandingPageURI" type="xs:anyURI" minOccurs="0">
                     <xs:annotation>
                         <xs:documentation>

diff --git a/fcs-core-2.0/changelog.adoc b/fcs-core-2.0/changelog.adoc
@@ -4,6 +4,12 @@
 
 // --- Github ---
 
+[discrete]
+== 2024-09-04 -- Add EndpointDescription > Resource > Institution element
+
+* Add new optional `<ed:Institution>` element to further describe `<ed:Resource>`s in the _Endpoint Description_.
+* Proofing.
+
 [discrete]
 == 2024-04-10 -- Static Github Pages with builds from specification sources
 // https://github.com/clarin-eric/fcs-misc/commit/c1a01f0515216508262010347573d69e4a41aafb

diff --git a/fcs-core-2.0/interface-specification.adoc b/fcs-core-2.0/interface-specification.adoc
@@ -82,6 +82,10 @@ A human-readable title for the resource. A `REQUIRED` `@xml:lang` attribute indi
 +
 An optional human-readable description of the resource. It `SHOULD` be at most one sentence. A `REQUIRED` `@xml:lang` attribute indicates the language of the description. If supplied, an English version of the description is `REQUIRED`. The list of descriptions `MUST NOT` contain duplicate entries for the same language.
 
+* zero or more `<ed:Institution>` elements (`OPTIONAL`)
++
+An optional human-readable name for the institution of the resource. A `REQUIRED` `@xml:lang` attribute indicates the language of the institution name. If supplied, an English version of the institution name is `REQUIRED`. If there is no English translation available, the element with the English language should contain the original institution name. The list of institution names `MUST NOT` contain duplicate entries for the same language.
+
 * zero or one `<ed:LandingPageURI>` element (`OPTIONAL`)
 +
 A link to a website for the resource, e.g. a landing page for a resource, i.e. a web-site that describes a corpus.