# DS-V7

The specification version **DS-V7** introduces improvements and new features based on version **DS-V5**, which include:

* Adaptions to the DS and Data matching
* Adaptions and fixes for some terms, and the DS structure
* Adaptions to the `@context`
* Introduction of new terms
* Support for multilingual metadata
* Improved handling of language-tagged strings
* Introduction of Sub-DS and references (internal and external)

A detailed listing of all changes to the previous specification version can be found in the [Changelog](https://gitbook.semantify.it/domainspecifications/ds-v7/changelog).

A detailed listing of patches for this specification version can be found below (patches are changes to the specification that happen after the specification version has been published).

## Content

* [Standard @context](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/context) - The standard `@context` that is used for Domain Specifications and Verification Reports.
* [Grammar](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar) - Formal specification of the components (node types, terms, etc.) of Domain Specifications and Verification Reports.
* [Changelog](https://gitbook.semantify.it/domainspecifications/ds-v7/changelog) - A detailed listing of all changes and additions of **DS-V7** in comparison to **DS-V5**.
* [Developer Notes](https://gitbook.semantify.it/domainspecifications/ds-v7/devnotes) - Guidelines for developers building software around Domain Specifications.
* [Examples](https://gitbook.semantify.it/domainspecifications/ds-v7/examples) - Example files for Domain Specifications and Verification Reports.

## Patches

* **\[2024-12-17]**
  * Removed `rdf:HTML` as datatype from the specification.
* **\[2022-06-13]**
  * The range for `ds:defaultLanguage` has been changed from a string to an array of strings. This means multiple languages can be defined as "default". See [Grammar/DomainSpecification/DataType](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/datatype) for details.
* **\[2022-03-22]**
  * Adapted chapter **3.2.2.3. sh:pattern & sh:flags** in [Grammar/DomainSpecification/DataType](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/datatype): `sh:flags` has been corrected in all occurrences (was `sh:flag` sometimes). Details about the use and syntax of `sh:pattern` and `sh:flags` have been added.
* **\[2022-01-07]**
  * Added `rdfs:label` and `rdfs:comment` as options for all DS grammar node types to be able to express metadata, except for the DomainSpecification-node, since it already has `schema:name` and `schema:description` for this purpose. The corresponding grammar node pages have been updated.
    * [Grammar/DomainSpecification/Class](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/class).
    * [Grammar/DomainSpecification/Enumeration](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/enumeration).
    * [Grammar/DomainSpecification/DataType](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/datatype).
    * [Grammar/DomainSpecification/Property](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/property).
* **\[2021-10-18]**
  * `ds:propertyDisplayOrder` is introduced as a new property for the DS root node and Class nodes. It replaces `sh:order` in property nodes, which is deprecated now. Details at [Grammar/DomainSpecification/DomainSpecification](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/domainspecification). A corresponding entry in the standard `@context` is added.
  * [Examples](https://gitbook.semantify.it/domainspecifications/ds-v7/examples) have been updated to use the new property instead of `sh:order`.
* **\[2021-09-28]**
  * `rdf:HTML` as introduced as a new datatype. Added chapter 3.1.2. and adapted mapping-table in chapter 3.1. in [Grammar/DomainSpecification/DataType](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/datatype).
  * The DS-Path Syntax is introduced at [Grammar/DsPath/README.md](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/dspath). This syntax can be used for the verification report or for any application that needs pointer to a specific node of a DS.
* **\[2021-07-07]**
  * Removed chapter 3.3. about internal references from [Grammar/DomainSpecification/Class](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/class).
  * All changes and details regarding internal and external references, Super-DS, and the resolving of these relations (population) have been added to chapter 3.5. of [Grammar/DomainSpecification/DomainSpecification](https://gitbook.semantify.it/domainspecifications/ds-v7/grammar/domainspecification/domainspecification).
  * Examples for the population process have been added to [Examples](https://gitbook.semantify.it/domainspecifications/ds-v7/examples).