search

opengeospatial / CoverageJSON

Public repo for CoverageJSON project
Apache License 2.0
10 stars 8 forks source link

Several clarifications to the text requested - 1 #104

Closed chris-little closed 2 years ago

chris-little commented 2 years ago

@joanma747 identified several areas of confusion requiring improvements to the text. These have been split into 8 separate sub-issues:

  1. The reference to the modular spec is confusing and should not be there: "This document also uses terms defined in the OGC Standard for Modular specifications (OGC 08-131r3), also known as the ‘ModSpec’. The definitions of terms such as standard, specification, requirement, and conformance test are provided in the ModSpec." In my opinion the document ignores de modspec and does not define requirements ore requirements classes etc. This is "ok" for a community standard but then lets not create false expectations.
chris-little commented 2 years ago

@joanma747 I propose to remove the complete paragraph and replace with: This community specification does not follow the OGC Standard for Modular specifications (OGC 08-131r3), also known as the ‘ModSpec’. Conformance against the specification is by testing a CoverageJSON instance against the JSON Schema at https://covjson.org/schema/dev/coveragejson.json . The schema is also built into the [Sandbox/Playground](https://covjson.org/playground/).

chris-little commented 2 years ago

@joanma747 The PDF was out of date. The ModSpec section was replaced on 30 jun 2022, and currently reads

Conformance with this specification shall be checked using the [JSON schema](https://github.com/covjson/covjson-validator/tree/main/schemas). The schema bundle has been incorporated into the [CoverageJSON Community Playground](https://covjson.org/playground/) which can test files for conformance. Simple guidance on CoverageJSON is available at the [Community Cookbook](https://covjson.org/cookbook/).

The one Standardization Target for this specification is the format of CoverageJSON.

In order to conform to this OGC® Community Standard, a software implementation shall implement any CoverageJSON object as a valid JSON object that conforms to the CoverageJSON schema.

All requirements-classes and conformance-classes described in this document are owned by the standard(s) identified.

chris-little commented 2 years ago

@joanma747 Can we close this issue now?

joanma747 commented 2 years ago

Fine with me