Skip to content

Commit a3aa4cc

Browse files
committed
Align namespaces; remove conventions from README
1 parent 874f031 commit a3aa4cc

13 files changed

Lines changed: 39 additions & 76 deletions

File tree

README.md

Lines changed: 0 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -53,37 +53,6 @@ working directory:
5353
- `debug-shapes-processed.ttl`: the parameterized and combined policies
5454
- `debug-validation-report.ttl`: the detailed SHACL validation report (`sh:ValidationReport`)
5555

56-
## Conventions
57-
58-
All examples in this repository use the following namespace prefix bindings:
59-
60-
```turtle
61-
@prefix codemeta: <https://doi.org/10.5063/schema/codemeta-2.0#> .
62-
@prefix owl: <http://www.w3.org/2002/07/owl#> .
63-
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
64-
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
65-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
66-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
67-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
68-
@prefix schema: <https://schema.org/> .
69-
@prefix sh: <http://www.w3.org/ns/shacl#> .
70-
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
71-
```
72-
73-
For Software CaRD, the prefixes
74-
[`sc:`](https://schema.software-metadata.pub/software-card/2025-01-01/#),
75-
[`scex:`](https://schema.software-metadata.pub/software-card/2025-01-01/examples/#), and
76-
[`scimpl:`](https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#)
77-
were established and are used for the following purposes:
78-
79-
- `sc:` contains terms exposed to users
80-
- `scex:` contains example uses of `sc:` and `sh:` terms
81-
- `scimpl:` contains internal implementation details
82-
83-
The associated IRIs currently don't exist.
84-
A [search on prefix.cc](https://prefix.cc/sc) reveals prior usage of the prefix `sc:` by projects which seem to be
85-
defunct.
86-
8756
## Documentation
8857

8958
To build the documentation, install the package including the `docs` extra:

docs/specification/conventions.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -17,28 +17,22 @@ RDF examples use the following namespace prefixes (this declaration is omitted f
1717

1818
```turtle
1919
@prefix codemeta: <https://doi.org/10.5063/schema/codemeta-2.0#> .
20+
@prefix owl: <http://www.w3.org/2002/07/owl#> .
2021
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
2122
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
2223
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
2324
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
24-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementations/#> .
25+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
2526
@prefix schema: <https://schema.org/> .
2627
@prefix sh: <http://www.w3.org/ns/shacl#> .
2728
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
2829
```
2930

30-
**Namespace Purposes:**
31-
32-
- `sc:` - Core Software CaRD vocabulary for features like parameterization
33-
- `scex:` - Example policies and data
34-
- `scimpl:` - Implementations, e.g. SHACL Constraints
35-
- `sh:` - SHACL vocabulary for defining validation shapes
36-
- `schema:` - Schema.org vocabulary for software metadata
37-
- `codemeta:` - CodeMeta extensions to Schema.org
38-
- `xsd:` - XML Schema datatypes
39-
- `rdf:` and `rdfs:` - Core RDF and RDF schema vocabularies
40-
31+
For Software CaRD, these prefixes were established:
4132

33+
- [`sc:`](https://schema.software-metadata.pub/software-card/2025-01/#) - Core Software CaRD vocabulary exposed to the users
34+
- [`scex:`](https://schema.software-metadata.pub/software-card/2025-01/examples/#) - Example policies and data
35+
- [`scimpl:`](https://schema.software-metadata.pub/software-card/2025-01/implementation/#) - Implementation details
4236

4337
## Glossary
4438

examples/components/orcid.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
@prefix owl: <http://www.w3.org/2002/07/owl#> .
77
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
88
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
9-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
10-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
11-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
9+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
10+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
11+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1212
@prefix schema: <https://schema.org/> .
1313
@prefix sh: <http://www.w3.org/ns/shacl#> .
1414
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/data/hermes.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@
1111
@prefix owl: <http://www.w3.org/2002/07/owl#> .
1212
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
1313
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
14-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
15-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
16-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
14+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
15+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
16+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1717
@prefix schema: <https://schema.org/> .
1818
@prefix sh: <http://www.w3.org/ns/shacl#> .
1919
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/policies/_collection.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
@prefix owl: <http://www.w3.org/2002/07/owl#> .
99
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
1010
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
11-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
12-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
13-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
11+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
12+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
13+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1414
@prefix schema: <https://schema.org/> .
1515
@prefix sh: <http://www.w3.org/ns/shacl#> .
1616
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/policies/authors-affiliation.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
@prefix owl: <http://www.w3.org/2002/07/owl#> .
77
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
88
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
9-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
10-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
11-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
9+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
10+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
11+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1212
@prefix schema: <https://schema.org/> .
1313
@prefix sh: <http://www.w3.org/ns/shacl#> .
1414
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/policies/authors.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
@prefix owl: <http://www.w3.org/2002/07/owl#> .
77
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
88
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
9-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
10-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
11-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
9+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
10+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
11+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1212
@prefix schema: <https://schema.org/> .
1313
@prefix sh: <http://www.w3.org/ns/shacl#> .
1414
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/policies/description-parameterizable.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
@prefix owl: <http://www.w3.org/2002/07/owl#> .
77
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
88
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
9-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
10-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
11-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
9+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
10+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
11+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1212
@prefix schema: <https://schema.org/> .
1313
@prefix sh: <http://www.w3.org/ns/shacl#> .
1414
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/policies/helmholtz-codebase.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
@prefix owl: <http://www.w3.org/2002/07/owl#> .
77
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
88
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
9-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
10-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
11-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
9+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
10+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
11+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1212
@prefix schema: <https://schema.org/> .
1313
@prefix sh: <http://www.w3.org/ns/shacl#> .
1414
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

examples/policies/license.ttl

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66
@prefix owl: <http://www.w3.org/2002/07/owl#> .
77
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
88
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
9-
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01-01/#> .
10-
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01-01/examples/#> .
11-
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01-01/implementation/#> .
9+
@prefix sc: <https://schema.software-metadata.pub/software-card/2025-01/#> .
10+
@prefix scex: <https://schema.software-metadata.pub/software-card/2025-01/examples/#> .
11+
@prefix scimpl: <https://schema.software-metadata.pub/software-card/2025-01/implementation/#> .
1212
@prefix schema: <https://schema.org/> .
1313
@prefix sh: <http://www.w3.org/ns/shacl#> .
1414
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

0 commit comments

Comments
 (0)