Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,7 @@
<section id='H2' data-include-format="markdown" data-include="respec/H2-kenmerken-van-begrippen.md"></section>
<section id='H3' data-include-format="markdown" data-include="respec/H3-begrippenkader.md" class="informative"></section>
<section id='H4' data-include-format="markdown" data-include="respec/H4-taalbinding.md"></section>
<section id='conformance'>
<!-- This section is filled automatically by ReSpec. -->
</section>
<section id='H5' data-include-format="markdown" data-include="respec/H5-conformiteit.md"></section>
<section id="index" class="appendix"></section>
<section class="appendix" data-include-format="markdown" data-include="respec/conventies.md"></section>
<!-- <section data-include-format="markdown" data-include="respec/rdf2markdown/en-woordenboek-table.md" class="appendix"></section> -->
Expand Down
13 changes: 13 additions & 0 deletions respec/H5-conformiteit.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@

# Conformiteit

Naast onderdelen die als niet-normatief gemarkeerd zijn, zijn ook alle diagrammen, voorbeelden, en noten in dit document niet-normatief. Verder is alles in dit document normatief.


## SHACL-validatiemeldingen

Voor het valideren van begrippenkaders conform de NL-SBB-standaard wordt gebruikgemaakt van SHACL-validatieregels. Bij een validatie kunnen drie typen meldingen voorkomen: `sh:Violation`, `sh:Warning` en `sh:Info` .

- **`sh:Violation`** – Geeft aan dat een verplichte validatieregel uit de NL-SBB-standaard is overtreden. Een begrippenkader met één of meer `sh:Violation`-meldingen is niet conform de standaard.
- **`sh:Warning`** – Geeft aan dat niet wordt voldaan aan een aanbevolen kwaliteitsregel of best practice. `sh:Warning`-meldingen hebben geen gevolgen voor de conformiteit met de standaard, maar het wordt aanbevolen deze te beoordelen en waar mogelijk op te lossen.
- **`sh:Info`** – Geeft aanvullende informatie of suggesties ter verbetering van de kwaliteit, consistentie of herbruikbaarheid van het begrippenkader. `sh:Info`-meldingen hebben geen gevolgen voor de conformiteit met de standaard.
17 changes: 12 additions & 5 deletions snapshot.html
Original file line number Diff line number Diff line change
Expand Up @@ -456,7 +456,7 @@
}</script>
<link rel="stylesheet" href="https://tools.geostandaarden.nl/respec/style/base.css"></head>

<body class="h-entry"><div class="head">
<body class="h-entry informative"><div class="head">
<a class="logo" href="https://www.geonovum.nl/geo-standaarden"><img alt="Geonovum" height="67" id="Geonovum" src="https://docs.geostandaarden.nl/media/Geonovum.svg" width="132">
</a> <h1 id="title" class="title">NL-SBB - Standaard voor het beschrijven van begrippen</h1>

Expand Down Expand Up @@ -550,7 +550,7 @@ <h2>
<section id="abstract" class="introductory"><h2>Samenvatting</h2><p>De <strong>standaard voor het beschrijven van begrippen</strong> geeft aan hoe begrippen in een begrippenlijst, taxonomie of thesaurus eenduidig worden beschreven. Er is aandacht voor uitleg in begrijpelijke taal (B1 niveau) en de verwijzing naar de (juridische) grondslag van een begrip in een geschreven bron of een bron op het internet (zoals wetten.nl).
De standaard kent een taalbinding waarmee een begrippenkader als Linked data kan worden gepubliceerd. Daarbij wordt gebruik gemaakt van met name SKOS, maar de standaard kan ook worden gebruikt zonder gebruik te maken van Linked data. Daarmee kunnen organisaties los van de door hen gebruikte technologie de standaard toepassen als stap op weg naar semantische interoperabiliteit. <strong>Best Practice</strong> Naast dit normatieve document is er een apart gepubliceerde niet normatieve begeleidende best practice: <a href="http://docs.geostandaarden.nl/nl-sbb/bp">Best Practices en aanvullingen voor NL-SBB - Standaard voor het beschrijven van begrippen</a>.</p>
</section>
<section id="sotd" class="introductory"><h2>Status van dit document</h2><p>Dit is een werkversie die op elk moment kan worden gewijzigd, verwijderd of vervangen door andere documenten. Het is geen stabiel document.</p></section><nav id="toc"><h2 class="introductory" id="inhoudsopgave">Inhoudsopgave</h2><ol class="toc"><li class="tocline"><a class="tocxref" href="#abstract">Samenvatting</a></li><li class="tocline"><a class="tocxref" href="#sotd">Status van dit document</a></li><li class="tocline"><a class="tocxref" href="#H1"><bdi class="secno">1. </bdi>Inleiding</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#toepassingsgebied"><bdi class="secno">1.1 </bdi>Toepassingsgebied</a></li><li class="tocline"><a class="tocxref" href="#doelgroep"><bdi class="secno">1.2 </bdi>Doelgroep</a></li><li class="tocline"><a class="tocxref" href="#onderbouwing"><bdi class="secno">1.3 </bdi>Onderbouwing</a></li><li class="tocline"><a class="tocxref" href="#use-cases"><bdi class="secno">1.4 </bdi>Use cases</a></li><li class="tocline"><a class="tocxref" href="#leeswijzer"><bdi class="secno">1.5 </bdi>Leeswijzer</a></li></ol></li><li class="tocline"><a class="tocxref" href="#H2"><bdi class="secno">2. </bdi>Kenmerken van begrippen</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#overzicht"><bdi class="secno">2.1 </bdi>Overzicht</a></li><li class="tocline"><a class="tocxref" href="#conventies"><bdi class="secno">2.2 </bdi>Conventies</a></li><li class="tocline"><a class="tocxref" href="#begrip"><bdi class="secno">2.3 </bdi>Begrip</a></li><li class="tocline"><a class="tocxref" href="#begrippenkader"><bdi class="secno">2.4 </bdi>Begrippenkader</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#begrippenlijst"><bdi class="secno">2.4.1 </bdi>Begrippenlijst</a><ol class="toc"></ol></li><li class="tocline"><a class="tocxref" href="#taxonomie"><bdi class="secno">2.4.2 </bdi>Taxonomie</a></li><li class="tocline"><a class="tocxref" href="#thesaurus"><bdi class="secno">2.4.3 </bdi>Thesaurus</a><ol class="toc"></ol></li><li class="tocline"><a class="tocxref" href="#harmonisatiesrelaties"><bdi class="secno">2.4.4 </bdi>Harmonisatiesrelaties</a></li></ol></li><li class="tocline"><a class="tocxref" href="#brondocument"><bdi class="secno">2.5 </bdi>Brondocument</a></li><li class="tocline"><a class="tocxref" href="#collectie"><bdi class="secno">2.6 </bdi>Collectie</a></li></ol></li><li class="tocline"><a class="tocxref" href="#H3"><bdi class="secno">3. </bdi>Begrippenkader</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#begrippenlijst-0"><bdi class="secno">3.1 </bdi>Begrippenlijst</a></li><li class="tocline"><a class="tocxref" href="#taxonomie-0"><bdi class="secno">3.2 </bdi>Taxonomie</a></li><li class="tocline"><a class="tocxref" href="#thesaurus-0"><bdi class="secno">3.3 </bdi>Thesaurus</a></li></ol></li><li class="tocline"><a class="tocxref" href="#H4"><bdi class="secno">4. </bdi>Toepassingsprofiel in RDF</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#overzicht-0"><bdi class="secno">4.1 </bdi>Overzicht</a></li><li class="tocline"><a class="tocxref" href="#uitwerking"><bdi class="secno">4.2 </bdi>Uitwerking</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#types"><bdi class="secno">4.2.1 </bdi>Types</a></li><li class="tocline"><a class="tocxref" href="#eigenschappen"><bdi class="secno">4.2.2 </bdi>Eigenschappen</a></li></ol></li><li class="tocline"><a class="tocxref" href="#specificatie"><bdi class="secno">4.3 </bdi>Specificatie</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#specificatie-begrippenkader"><bdi class="secno">4.3.1 </bdi>Specificatie begrippenkader</a></li><li class="tocline"><a class="tocxref" href="#specificatie-begrip"><bdi class="secno">4.3.2 </bdi>Specificatie begrip</a></li><li class="tocline"><a class="tocxref" href="#specificatie-brondocument"><bdi class="secno">4.3.3 </bdi>Specificatie brondocument</a></li><li class="tocline"><a class="tocxref" href="#specificatie-collectie"><bdi class="secno">4.3.4 </bdi>Specificatie collectie</a></li></ol></li></ol></li><li class="tocline"><a class="tocxref" href="#conformance"><bdi class="secno">5. </bdi>Conformiteit</a></li><li class="tocline"><a class="tocxref" href="#index"><bdi class="secno">A. </bdi>Index</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#index-defined-here"><bdi class="secno">A.1 </bdi>Termen gedefinieerd door deze specificatie</a></li><li class="tocline"><a class="tocxref" href="#index-defined-elsewhere"><bdi class="secno">A.2 </bdi>Termen gedefinieerd door verwijzing</a></li></ol></li><li class="tocline"><a class="tocxref" href="#namespace-verklaringen"><bdi class="secno">B. </bdi>Namespace verklaringen</a></li><li class="tocline"><a class="tocxref" href="#references"><bdi class="secno">C. </bdi>Referenties</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#informatieve-referenties"><bdi class="secno">C.1 </bdi>Informatieve referenties</a></li></ol></li></ol></nav>
<section id="sotd" class="introductory"><h2>Status van dit document</h2><p>Dit is een werkversie die op elk moment kan worden gewijzigd, verwijderd of vervangen door andere documenten. Het is geen stabiel document.</p></section><nav id="toc"><h2 class="introductory" id="inhoudsopgave">Inhoudsopgave</h2><ol class="toc"><li class="tocline"><a class="tocxref" href="#abstract">Samenvatting</a></li><li class="tocline"><a class="tocxref" href="#sotd">Status van dit document</a></li><li class="tocline"><a class="tocxref" href="#H1"><bdi class="secno">1. </bdi>Inleiding</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#toepassingsgebied"><bdi class="secno">1.1 </bdi>Toepassingsgebied</a></li><li class="tocline"><a class="tocxref" href="#doelgroep"><bdi class="secno">1.2 </bdi>Doelgroep</a></li><li class="tocline"><a class="tocxref" href="#onderbouwing"><bdi class="secno">1.3 </bdi>Onderbouwing</a></li><li class="tocline"><a class="tocxref" href="#use-cases"><bdi class="secno">1.4 </bdi>Use cases</a></li><li class="tocline"><a class="tocxref" href="#leeswijzer"><bdi class="secno">1.5 </bdi>Leeswijzer</a></li></ol></li><li class="tocline"><a class="tocxref" href="#H2"><bdi class="secno">2. </bdi>Kenmerken van begrippen</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#overzicht"><bdi class="secno">2.1 </bdi>Overzicht</a></li><li class="tocline"><a class="tocxref" href="#conventies"><bdi class="secno">2.2 </bdi>Conventies</a></li><li class="tocline"><a class="tocxref" href="#begrip"><bdi class="secno">2.3 </bdi>Begrip</a></li><li class="tocline"><a class="tocxref" href="#begrippenkader"><bdi class="secno">2.4 </bdi>Begrippenkader</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#begrippenlijst"><bdi class="secno">2.4.1 </bdi>Begrippenlijst</a><ol class="toc"></ol></li><li class="tocline"><a class="tocxref" href="#taxonomie"><bdi class="secno">2.4.2 </bdi>Taxonomie</a></li><li class="tocline"><a class="tocxref" href="#thesaurus"><bdi class="secno">2.4.3 </bdi>Thesaurus</a><ol class="toc"></ol></li><li class="tocline"><a class="tocxref" href="#harmonisatiesrelaties"><bdi class="secno">2.4.4 </bdi>Harmonisatiesrelaties</a></li></ol></li><li class="tocline"><a class="tocxref" href="#brondocument"><bdi class="secno">2.5 </bdi>Brondocument</a></li><li class="tocline"><a class="tocxref" href="#collectie"><bdi class="secno">2.6 </bdi>Collectie</a></li></ol></li><li class="tocline"><a class="tocxref" href="#H3"><bdi class="secno">3. </bdi>Begrippenkader</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#begrippenlijst-0"><bdi class="secno">3.1 </bdi>Begrippenlijst</a></li><li class="tocline"><a class="tocxref" href="#taxonomie-0"><bdi class="secno">3.2 </bdi>Taxonomie</a></li><li class="tocline"><a class="tocxref" href="#thesaurus-0"><bdi class="secno">3.3 </bdi>Thesaurus</a></li></ol></li><li class="tocline"><a class="tocxref" href="#H4"><bdi class="secno">4. </bdi>Toepassingsprofiel in RDF</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#overzicht-0"><bdi class="secno">4.1 </bdi>Overzicht</a></li><li class="tocline"><a class="tocxref" href="#uitwerking"><bdi class="secno">4.2 </bdi>Uitwerking</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#types"><bdi class="secno">4.2.1 </bdi>Types</a></li><li class="tocline"><a class="tocxref" href="#eigenschappen"><bdi class="secno">4.2.2 </bdi>Eigenschappen</a></li></ol></li><li class="tocline"><a class="tocxref" href="#specificatie"><bdi class="secno">4.3 </bdi>Specificatie</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#specificatie-begrippenkader"><bdi class="secno">4.3.1 </bdi>Specificatie begrippenkader</a></li><li class="tocline"><a class="tocxref" href="#specificatie-begrip"><bdi class="secno">4.3.2 </bdi>Specificatie begrip</a></li><li class="tocline"><a class="tocxref" href="#specificatie-brondocument"><bdi class="secno">4.3.3 </bdi>Specificatie brondocument</a></li><li class="tocline"><a class="tocxref" href="#specificatie-collectie"><bdi class="secno">4.3.4 </bdi>Specificatie collectie</a></li></ol></li></ol></li><li class="tocline"><a class="tocxref" href="#H5"><bdi class="secno">5. </bdi>Conformiteit</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#shacl-validatiemeldingen"><bdi class="secno">5.1 </bdi>SHACL-validatiemeldingen</a></li></ol></li><li class="tocline"><a class="tocxref" href="#index"><bdi class="secno">A. </bdi>Index</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#index-defined-here"><bdi class="secno">A.1 </bdi>Termen gedefinieerd door deze specificatie</a></li><li class="tocline"><a class="tocxref" href="#index-defined-elsewhere"><bdi class="secno">A.2 </bdi>Termen gedefinieerd door verwijzing</a></li></ol></li><li class="tocline"><a class="tocxref" href="#namespace-verklaringen"><bdi class="secno">B. </bdi>Namespace verklaringen</a></li><li class="tocline"><a class="tocxref" href="#references"><bdi class="secno">C. </bdi>Referenties</a><ol class="toc"><li class="tocline"><a class="tocxref" href="#informatieve-referenties"><bdi class="secno">C.1 </bdi>Informatieve referenties</a></li></ol></li></ol></nav>
<section id="H1" class="informative"><div class="header-wrapper"><h2 id="x1-inleiding"><bdi class="secno">1. </bdi>Inleiding</h2><a class="self-link" href="#H1" aria-label="Permalink for Section 1."></a></div><p><em>Dit onderdeel is niet-normatief.</em></p>
<section id="toepassingsgebied"><div class="header-wrapper"><h3 id="x1-1-toepassingsgebied"><bdi class="secno">1.1 </bdi>Toepassingsgebied</h3><a class="self-link" href="#toepassingsgebied" aria-label="Permalink for Section 1.1"></a></div>
<p>De voorliggende standaard richt zich op het beschrijven van begrippen in een begrippenkader. Dit maakt het mogelijk om:</p>
Expand Down Expand Up @@ -2438,9 +2438,16 @@ <h2>
</tr>
</tbody></table>
</section></section></section>
<section id="conformance"><div class="header-wrapper"><h2 id="x5-conformiteit"><bdi class="secno">5. </bdi>Conformiteit</h2><a class="self-link" href="#conformance" aria-label="Permalink for Section 5."></a></div><p>Naast onderdelen die als niet-normatief gemarkeerd zijn, zijn ook alle diagrammen, voorbeelden, en noten in dit document niet-normatief. Verder is alles in dit document normatief.</p>

</section>
<section id="H5"><div class="header-wrapper"><h2 id="x5-conformiteit"><bdi class="secno">5. </bdi>Conformiteit</h2><a class="self-link" href="#H5" aria-label="Permalink for Section 5."></a></div>
<p>Naast onderdelen die als niet-normatief gemarkeerd zijn, zijn ook alle diagrammen, voorbeelden, en noten in dit document niet-normatief. Verder is alles in dit document normatief.</p>
<section id="shacl-validatiemeldingen"><div class="header-wrapper"><h3 id="x5-1-shacl-validatiemeldingen"><bdi class="secno">5.1 </bdi>SHACL-validatiemeldingen</h3><a class="self-link" href="#shacl-validatiemeldingen" aria-label="Permalink for Section 5.1"></a></div>
<p>Voor het valideren van begrippenkaders conform de NL-SBB-standaard wordt gebruikgemaakt van SHACL-validatieregels. Bij een validatie kunnen drie typen meldingen voorkomen: <code>sh:Violation</code>, <code>sh:Warning</code> en <code>sh:Info</code> .</p>
<ul>
<li><strong><code>sh:Violation</code></strong> – Geeft aan dat een verplichte validatieregel uit de NL-SBB-standaard is overtreden. Een begrippenkader met één of meer <code>sh:Violation</code>-meldingen is niet conform de standaard.</li>
<li><strong><code>sh:Warning</code></strong> – Geeft aan dat niet wordt voldaan aan een aanbevolen kwaliteitsregel of best practice. <code>sh:Warning</code>-meldingen hebben geen gevolgen voor de conformiteit met de standaard, maar het wordt aanbevolen deze te beoordelen en waar mogelijk op te lossen.</li>
<li><strong><code>sh:Info</code></strong> – Geeft aanvullende informatie of suggesties ter verbetering van de kwaliteit, consistentie of herbruikbaarheid van het begrippenkader. <code>sh:Info</code>-meldingen hebben geen gevolgen voor de conformiteit met de standaard.</li>
</ul>
</section></section>
<section id="index" class="appendix"><div class="header-wrapper"><h2 id="a-index"><bdi class="secno">A. </bdi>Index</h2><a class="self-link" href="#index" aria-label="Permalink for Appendix A."></a></div><section id="index-defined-here">
<div class="header-wrapper"><h3 id="a-1-termen-gedefinieerd-door-deze-specificatie"><bdi class="secno">A.1 </bdi>Termen gedefinieerd door deze specificatie</h3><a class="self-link" href="#index-defined-here" aria-label="Permalink for Appendix A.1"></a></div>
<ul class="index">
Expand Down