Skip to content

Commit 0244830

Browse files
egekorkanrelu91JKRhb
authoredDec 6, 2023
Apply suggestions from code review
Co-authored-by: Cristiano Aguzzi <[email protected]> Co-authored-by: Jan Romann <[email protected]>
1 parent f7d58dc commit 0244830

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed
 

‎VOCABULARY-CREATION-GUIDE.md

+5-4
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ JSON-LD context file (`context.jsonld`) is necessary.
1414
This file maps the TD-specific vocabulary defined in the binding template to an
1515
OWL ontology (`ontology.ttl`), enabling the use of Semantic Web technologies.
1616
Finally, a JSON schema file (`example-protocol.schema.json`) should be provided
17-
to enable automatic validation of forms using the binding template.
17+
to enable automatic syntactic validation of forms using the binding template.
1818

1919
## Creating a New Vocabulary
2020

@@ -28,7 +28,7 @@ usable in requests.
2828
Vocabulary terms can also be more specific to a certain type of Interaction
2929
Affordance or operation type, e.g., Event Affordances or observable Properties.
3030

31-
The mapping then needs to be cast into vocabulary terms based on the Web
31+
The mapping then needs to be described as vocabulary terms based on the Web
3232
Ontology Language (OWL) and – more generally – the Resource Description
3333
Framework (RDF).
3434
This mapping can reuse existing, more general vocabularies and integrate them
@@ -46,8 +46,9 @@ To do so, a `template.sparql` file needs to be created based on
4646
[STTL](https://ns.inria.fr/sparql-template/), which defines rules for
4747
transforming a source RDF graph into a result text.
4848
The rules are applied to an `index.template.html` file which contains
49-
placeholders (`%s`) where the resulting tables are inserted.
50-
To be able to create these tables, the ontology vocabulary needs to be brought
49+
placeholders (`%s`) where a formatted version of the vocabulary terms
50+
(e.g., a table) can be inserted.
51+
To be able to create a formatted version, the ontology vocabulary needs to be brought
5152
into the right form using a mapping (in `mapping.ttl`) based on SHACL
5253
(Shapes Constraint Language).
5354

0 commit comments

Comments
 (0)
Please sign in to comment.