# 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](/domainspecifications/ds-v7/changelog.md).

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](/domainspecifications/ds-v7/grammar/domainspecification/context.md) - The standard `@context` that is used for Domain Specifications and Verification Reports.
* [Grammar](/domainspecifications/ds-v7/grammar.md) - Formal specification of the components (node types, terms, etc.) of Domain Specifications and Verification Reports.
* [Changelog](/domainspecifications/ds-v7/changelog.md) - A detailed listing of all changes and additions of **DS-V7** in comparison to **DS-V5**.
* [Developer Notes](/domainspecifications/ds-v7/devnotes.md) - Guidelines for developers building software around Domain Specifications.
* [Examples](/domainspecifications/ds-v7/examples.md) - 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](/domainspecifications/ds-v7/grammar/domainspecification/datatype.md) for details.
* **\[2022-03-22]**
  * Adapted chapter **3.2.2.3. sh:pattern & sh:flags** in [Grammar/DomainSpecification/DataType](/domainspecifications/ds-v7/grammar/domainspecification/datatype.md): `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](/domainspecifications/ds-v7/grammar/domainspecification/class.md).
    * [Grammar/DomainSpecification/Enumeration](/domainspecifications/ds-v7/grammar/domainspecification/enumeration.md).
    * [Grammar/DomainSpecification/DataType](/domainspecifications/ds-v7/grammar/domainspecification/datatype.md).
    * [Grammar/DomainSpecification/Property](/domainspecifications/ds-v7/grammar/domainspecification/property.md).
* **\[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](/domainspecifications/ds-v7/grammar/domainspecification/domainspecification.md). A corresponding entry in the standard `@context` is added.
  * [Examples](/domainspecifications/ds-v7/examples.md) 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](/domainspecifications/ds-v7/grammar/domainspecification/datatype.md).
  * The DS-Path Syntax is introduced at [Grammar/DsPath/README.md](/domainspecifications/ds-v7/grammar/dspath.md). 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](/domainspecifications/ds-v7/grammar/domainspecification/class.md).
  * 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](/domainspecifications/ds-v7/grammar/domainspecification/domainspecification.md).
  * Examples for the population process have been added to [Examples](/domainspecifications/ds-v7/examples.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.semantify.it/domainspecifications/ds-v7.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.