Merge pull request #181 from agiorguk/dev

archaeogeek · web-flow · commit a687a7a3a4c2 · 2025-03-04T17:45:56.000Z
Pull request from dev to live, to include the latest approved issues, namely: #61 #17 #16 #53 #62 #67 #152 #161 #87 #117 #96 #104 #153
diff --git a/.gitignore b/.gitignore
@@ -2,3 +2,4 @@
 docs/*.html
 pending/
 .github/workflows/*.yml
+/.vscode
diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@ Resources relating to the UK Gemini metadata profile
 
 Pull requests accepted to this branch get published to the GitPages repository at https://agiorguk.github.io/gemini/
 
-The published version of GEMINI 2.3 lives at https://agiorguk.github.io/gemini/1037-uk-gemini-introduction.html
+The published version of GEMINI 2.3 lives at https://agiorguk.github.io/gemini/1037-uk-gemini-introduction.html, and is licensed under a Creative Commons Attribution 4.0 International License (http://creativecommons.org/licenses/by/4.0/)
 
 Old home page: https://agiorguk.github.io/gemini/1037-uk-gemini-standard-and-inspire-implementing-rules.html (redirect from https://www.agi.org.uk/gemini/1037-uk-gemini-standard-and-inspire-implementing-rules/)
 
diff --git a/docs/1037-uk-gemini-introduction.asciidoc b/docs/1037-uk-gemini-introduction.asciidoc
@@ -13,7 +13,7 @@ entry points to the guidance:
 ** link:1051-uk-gemini-v2-2-specification-for-discovery-metadata-for-geospatial-resources.html[General introduction to GEMINI]
 ** link:1049-metadata-guidelines-for-geospatial-data-resources-part-2.html[General guidance for GEMINI]
 ** link:1048-uk-gemini-encoding-guidance.html[General guidance on the XML encoding of GEMINI]
-** https://github.com/AGIGemini/Schematron[Schematron rules for validating GEMINI records (GitHub link)]
+** https://github.com/agiorguk/gemini-schematron[Schematron rules for validating GEMINI records (GitHub link)]
 ** link:1056-glossary.html[Glossary of terms]
 ** link:1047-metadata-guidelines-for-geospatial-data-resources-part-3.html[List of references]
 ** link:1053-common-metadata-errors-uk-location-discovery-metadata-service.html[Common errors]
diff --git a/docs/1046-xml-element-order.asciidoc b/docs/1046-xml-element-order.asciidoc
@@ -18,6 +18,8 @@ to{nbsp}link:1037-uk-gemini-introduction.html[GEMINI
 |gmd:hierarchyLevelName |47 |Hierarchy level name
 |gmd:contact |35 |Metadata point of contact
 |gmd:dateStamp |30 |Metadata date
+|gmd:metadataStandardName |54 |Metadata standard name
+|gmd:metadataStandardVersion |55 |Metadata standard version
 |gmd:referenceSystemInfo |17 |Spatial reference system
 |gmd:identificationInfo | |
 |*_gmd:MD_DataIdentification_* | |
@@ -122,5 +124,6 @@ to{nbsp}link:1037-uk-gemini-introduction.html[GEMINI
 |   gmd:DQ_DomainConsistency |41 |Conformity
 |===
 
-_Last updated: April 2018_
-
+_Last updated: July 2024_
+http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative Commons Licence]] +
+This work is licensed under a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 International License]
diff --git a/docs/1048-uk-gemini-encoding-guidance.asciidoc b/docs/1048-uk-gemini-encoding-guidance.asciidoc
@@ -438,7 +438,7 @@ content, such as gmd:identificationInfo (Figure 9).
 The first XML child element of any GEMINI2 metadata instance shall be
 gmd:fileIdentifier. The content of this XML element is the identifier of
 the metadata instance. File identifier is not to be confused with the
-metadata item link:datasets.html#36[Resource Identifier].
+metadata item link:1062-gemini-datasets-and-data-series.html#36[Resource Identifier].
 
 The content of the XML element shall be a unique managed identifier,
 such as a system generated UUID. Once the identifier has been set for a
@@ -1044,7 +1044,7 @@ series, ISO 19115 hierarchyLevelName element must also be set, to
 
 ==== Detailed guidance for each metadata element
 
-link:datasets.html[Datasets]
+link:1062-gemini-datasets-and-data-series.html[Datasets]
 
 === Metadata for services
 
@@ -1109,7 +1109,7 @@ with null values with the nil reason being missing (Figure 25).
 
 ==== Detailed guidance for each metadata element
 
-link:services.html[Services]
+link:1063-gemini-services.html[Services]
 
 _Last technical update: March 2019_
 
diff --git a/docs/1051-uk-gemini-v2-2-specification-for-discovery-metadata-for-geospatial-resources.asciidoc b/docs/1051-uk-gemini-v2-2-specification-for-discovery-metadata-for-geospatial-resources.asciidoc
@@ -276,47 +276,6 @@ this element
 
 - *Errors observed* - observations on errors noted with each element
 
-== Extended metadata
-
-=== Additional metadata elements
-
-In many organisations, there is a need to record additional items of
-metadata to meet specific local requirements. This may be to incorporate
-particular characteristics of the data resources, or for particular
-applications. Additional metadata elements may be included in a metadata
-implementation. These elements should be taken from ISO 19115,
-which includes a comprehensive collection of metadata elements for
-geographic information, and also allows for further extensions.
-
-=== Extension of code lists
-
-Several metadata elements specified in UK GEMINI use enumerated code
-lists. These are pre-defined sets of values identified by codes. They
-are useful to standardise the entries to aid searches of metadata for
-specified values. The code lists included in UK GEMINI are taken from
-ISO 19115. In some cases, the explanations of the values have been
-modified to make them more appropriate to the UK context.
-
-Some of these code lists will require extension. Additional codes may be
-created as follows:
-
-. identify the new value, which should be distinct from existing values;
-. choose a name that encapsulates the essential concept;
-. provide a definition that is understandable and concise;
-. chose a new code that has not been used before for this element;
-. document the new codes, and disseminate them to users.
-
-Such code extensions may be either specific to a metadata implementation
-in an organisation or sector, or for general usage. In the latter case,
-proposed new codes should be
-submitted{nbsp}to{nbsp}gemini@agi.org.uk{nbsp}for
-inclusion in the next version of UK GEMINI. It is expected that future
-editions of UK GEMINI will incorporate such modified code lists.
-
-*Note that any new code values cannot be used in a national metadata
-service until incorporated in the Standard, nor will they be valid for
-the purposes of INSPIRE.*
-
 _Last updated: May 2018_
 
 http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative Commons Licence]] +
diff --git a/docs/1055-uk-gemini-major-changes-since-1-0.asciidoc b/docs/1055-uk-gemini-major-changes-since-1-0.asciidoc
@@ -57,6 +57,11 @@ longer just be the century.
 
 === Editorial changes since the launch of GEMINI 2.3
 
+==== TBC
+
+link:1062-gemini-datasets-and-data-series.html#19[Resource locator]: Add guidance on selecting appropriate OnLineFunctionCode
+link:1062-gemini-datasets-and-data-series.html#25[Limitations on public access]: For each reason to limit, add link to UK Statutory Instrument
+
 ==== May 2024
 
 First release after migrating to GitHub based maintenance and publication
diff --git a/docs/1062-gemini-datasets-and-data-series.adoc b/docs/1062-gemini-datasets-and-data-series.adoc
@@ -131,3 +131,6 @@ include::./partials/dataquality.asciidoc[tag=!service]
 include::./partials/maintenanceinformation.asciidoc[tag=!service]
 
 Go to <<top, top of page>>
+
+http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative Commons Licence]] +
+This work is licensed under a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 International License]
diff --git a/docs/1063-gemini-services.adoc b/docs/1063-gemini-services.adoc
@@ -106,3 +106,6 @@ include::./partials/boundingbox.asciidoc[tag=!dataset]
 include::./partials/qualityscope.asciidoc[tag=!dataset]
 
 Go to <<top, top of page>>
+
+http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative Commons Licence]] +
+This work is licensed under a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 International License]
diff --git a/docs/1250-element-summary.asciidoc b/docs/1250-element-summary.asciidoc
@@ -113,3 +113,6 @@ Note. Element numbers 9, 11, 12, 13, 14, 20, 22, 28, 29, 31, 32, 40 and
 have now been deleted from the Standard, and have not been reallocated
 to avoid confusion.
 
+http://creativecommons.org/licenses/by/4.0/[image:https://i.creativecommons.org/l/by/4.0/88x31.png[Creative Commons Licence]] +
+This work is licensed under a{nbsp}http://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 International License]
+
diff --git a/docs/partials/alternatetitle.asciidoc b/docs/partials/alternatetitle.asciidoc
@@ -22,8 +22,7 @@ alternative titles by which the data resource is known.
 
 |Guidance a|
 . Should be provided when the data resource has more than one title.
-. There is no need to fill in this entry unless there are other names
-used for the dataset, for example historic names.
+. There is no need to fill in this entry unless there are other names in use.
 . Commonly used abbreviations or acronyms should be recorded. If the
 acronym or abbreviation has been used in the main Title, then use the
 full name in the Alternative Title.
@@ -106,4 +105,4 @@ include::../snippets/service-alternatetitle-multi.xml[]
 [%collapsible]
 ====
 No error information available
-====
+====
diff --git a/docs/partials/boundingbox.asciidoc b/docs/partials/boundingbox.asciidoc
@@ -63,7 +63,9 @@ extent on a global basis. The bounding box is implicitly in WGS84.
 
 |Comment |The bounding box will often cover areas that are not directly
 related to the area covered by the resource.
-
+# tag::service[]
+The bounding box of a service may be larger or smaller than that of the datasets it can return.
+# end::service[]
 |Examples |-9.23, 2.69, 49.84, 60.85
 
 |Revision date |December 2012
@@ -109,11 +111,15 @@ Bounding box, which was made multiple
 |===
 |Guidelines
 |
-. The encoding example for geographic bounding box for datasets is shown
-in the example
-. Note that the extent XML element is in the gmd namespace. This differs
-from service metadata instances where the extent XML element will be in
-the srv namespace.
+# tag::service[]
+. The encoding is very similar to that used in metadata
+instances for datasets or series, except that the extent XML element is
+in the srv namespace instead of gmd. This is because extent is a
+property of MD_DataIdentification (ISO 19115) and
+SV_ServiceIdentification (ISO 19119/Amd 1:2008), not a property of the
+parent MD_Identification.
+. Note that the EX_Extent XML element is in the gmd namespace, even though it is being used to describe a service.
+# end::service[]
 . The definition of the equivalent ISO 19115 class,
 EX_GeographicBoundingBox, is 'Geographic area of the entire dataset
 referenced to WGS 84'. Consequently, the CRS of the coordinates
@@ -122,15 +128,6 @@ http://www.opengis.net/def/crs/EPSG/0/4326). This means that the
 coordinate values shall be expressed in units of degrees (encoded using
 decimal numbers) with axes orientated north and east. The geodetic datum
 is WGS 84.
-
-# tag::service[]
-Note that the encoding is very similar to that used in metadata
-instances for datasets or series, except that the extent XML element is
-in the srv namespace instead of gmd. This is because extent is a
-property of MD_DataIdentification (ISO 19115) and
-SV_ServiceIdentification (ISO 19119/Amd 1:2008), not a property of the
-parent MD_Identification.
-# end::service[]
 |Example
 |
 [source,xml]
@@ -166,4 +163,4 @@ Six decimal places of a degree is something like 1cm, so the longitude
 above is being given to roughly the nearest molecule.
 
 |===
-====
+====
diff --git a/docs/partials/conformity.asciidoc b/docs/partials/conformity.asciidoc
@@ -10,7 +10,7 @@ include::includes/partials-attributes.adoc[]
 user requirement
 
 |Purpose and meaning |The purpose of this is to record the conformity to
-INSPIRE and any other data specification
+INSPIRE and any other specification
 
 |Obligation |Mandatory
 
@@ -31,12 +31,12 @@ For details see below. +
 !===
 !Metadata element name !specification !degree !explanation
 !Definition !Citation of the product specification or user requirement
-against which data resource is evaluated !degree of conformity with the
+against which the resource is evaluated !degree of conformity with the
 specification !meaning of conformance for this result
 
 !Meaning !The purpose of this element is to identify the specification
 against which conformity is evaluated !The purpose of this element is to
-identify the conformity of the data resource to the cited specification
+identify the conformity of the resource to the cited specification
 !The purpose of this element is to explain the meaning of conformity in
 this context
 
@@ -49,10 +49,10 @@ this context
 !Domain ! !true if conformant +
 false if not conformant !free text
 
-!Rules !Cite the specification to which the data resource should conform
-!The data resource should be evaluated against the specification and the
+!Rules !Cite the specification to which the resource should conform
+!The resource should be evaluated against the specification and the
 result recorded !Include a statement about which aspects of the
-specification the data resource conforms and any exceptions
+specification the resource conforms to, and any exceptions
 
 !Examples !D2.8.I.5 INSPIRE Data Specification on Addresses -
 Guidelines, publication, 2010-04-26 !true !Only mandatory items included
diff --git a/docs/partials/datasetreferencedate.asciidoc b/docs/partials/datasetreferencedate.asciidoc
@@ -118,10 +118,10 @@ GEMINI 1 to 2.0: Addition of date type
 GEMINI2 also allows the date and time to be published in metadata. In
 this case the date encoding shown in Example Two must be used.
 * The format of date and date-time values is described at
-link:component/content/article?id=1048#2.2.3[Dates and Times]
+link:1048-uk-gemini-encoding-guidance.html#_dates_and_times[Dates and Times]
 * Dataset reference date shall include a date type. The content of this
 XML element is drawn from a
-link:component/content/article?id=1048#2.2.9[code list].
+link:1048-uk-gemini-encoding-guidance.html#_code_lists[code list].
 # tag::dataset[]
 | Example One: date
 |
diff --git a/docs/partials/limitationsonpublicaccess.asciidoc b/docs/partials/limitationsonpublicaccess.asciidoc
@@ -30,26 +30,36 @@ stated.
 . For INSPIRE: If no limitations apply, enter 'No limitations'.
 . INSPIRE recognises the following kinds of reasons for limiting public
 access, listed in Article 13(1):
-* (a) confidentiality of the proceedings of public authorities
-* (b) international relations, public security or national defence
-* (c) the course of justice
-* (d) confidentiality of commercial or industrial information
-* (e) intellectual property rights
-* (f) confidentiality of personal data
-* (g) interests of a person who supplied the data on a voluntary basis
-* (h) protection of the environment
+* (a) confidentiality of the proceedings of public authorities +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(d) of the UK INSPIRE Regulations 2009]
+* (b) international relations, public security or national defence +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(a) of the UK INSPIRE Regulations 2009]
+* (c) the course of justice +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(b) of the UK INSPIRE Regulations 2009]
+* (d) confidentiality of commercial or industrial information +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(e) of the UK INSPIRE Regulations 2009]
+* (e) intellectual property rights +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(c) of the UK INSPIRE Regulations 2009]
+* (f) confidentiality of personal data +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(2) of the UK INSPIRE Regulations 2009]
+* (g) interests of a person who supplied the data on a voluntary basis +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(f) of the UK INSPIRE Regulations 2009]
+* (h) protection of the environment +
+https://www.legislation.gov.uk/uksi/2009/3157/regulation/9[Regulation 9(5)(g) of the UK INSPIRE Regulations 2009]
 +
 Each has an entry with the full text, in the INSPIRE registry,
 http://inspire.ec.europa.eu/metadata-codelist/LimitationsOnPublicAccess
-. At least one limitation on public access shall give an INSPIRE reason
+. At least one limitation on public access shall give an INSPIRE reason.
+. If there is no applicable limitation listed in Article 13, then the closest limitation shall be chosen, and 
+a second limitations on public access element should be used to provide further information.
 
 |Comment |Limitations on public access are different from Use
 constraints which are warnings about its suitability for particular
 types of usage, or constraints on the use that can be made of the data.
 
 |Examples |No restriction on public access.
 
-|Revision date |June 2021
+|Revision date |October 2024
 |===
 
 .Corresponding element in other standards...
@@ -150,4 +160,4 @@ been left empty or where the PSMA (or similar) licensing arrangements
 are referenced there is either a lack of detail or no links to the
 appropriate sites.
 |===
-====
+====
diff --git a/docs/partials/resourcelocator.asciidoc b/docs/partials/resourcelocator.asciidoc
@@ -39,7 +39,15 @@ point to one of the values of the ISO 19139 code list
 CI_OnLineFunctionCode)
 * name (this appears on the data.gov.uk site)
 * description (data.gov.uk uses this if no 'name' provided)
-
+. Guidance on selecting appropriate OnLineFunctionCode value for function sub-element.
+!===
+!OnLineFunctionCode !	Meaning !	Example
+!download	! online instructions for transferring data from one storage device or system to another ! WFS Direct URL to file
+!information ! online information about the resource ! WMS Product page
+!offlineAccess ! online instructions for requesting the resource from the provider ! web page containing ordering information
+!order ! online order process for obtaining the resource ! Product ordering page
+!search ! online search interface for seeking out information about the resource ! distributors web site search page	
+!===
 |Comment a|
 The URL provided as the value of the gmd:linkage element should point to
 one of following type of resources:
@@ -77,7 +85,7 @@ included, for best results with data.gov.uk:
 .. name (this appears on the data.gov.uk site)
 . In relation to online INSPIRE network services, special guidance
 applies (see
-link:component/content/article?id=1054#data_servce_linking['Data and
+link:1054-operational-guide.html#_3_1_3_data_and_service_linking['Data and
 Service Linking']).
 * Identify whether the resource may be accessed.
 * Determine the location of the resource (may be a URL).
@@ -283,4 +291,4 @@ Defra metadata audit, October 2015: Very few records included direct
 links to WMS end points.
 
 |===
-====
+====
diff --git a/docs/partials/responsibleorganisation.asciidoc b/docs/partials/responsibleorganisation.asciidoc
@@ -82,6 +82,7 @@ for each.
 These appear in the data.gov.uk search results.
 . If the data was created by someone other than the Data Provider, this
 should also be recorded, using the role value 'Originator'.
+. If you need to identify an individual by name, use CI_ResponsibleParty.individualName. 
 
 |Comment |Facsimile number is no longer required
 
@@ -109,7 +110,7 @@ organisation !The mapping product manager
 acting as distributor, publisher, author, etc. !distributor
 !===
 
-|Revision date |July 2009
+|Revision date |July 2024
 |===
 
 .Corresponding element in other standards...
@@ -183,4 +184,4 @@ include::../snippets/service-responsibleorganisation.xml[]
 [%collapsible]
 ====
 No error information available
-====
+====
diff --git a/docs/partials/useconstraints.asciidoc b/docs/partials/useconstraints.asciidoc
diff --git a/docs/snippets/dataset-keyword-inspire.xml b/docs/snippets/dataset-keyword-inspire.xml
diff --git a/docs/snippets/service-extent-verticalcrs-reference.xml b/docs/snippets/service-extent-verticalcrs-reference.xml
diff --git a/docs/snippets/service-extent-verticalcrs-value.xml b/docs/snippets/service-extent-verticalcrs-value.xml
