Consultatieversie

pldn · Oct 30, 2023 · 9a145c3 · 9a145c3
1 parent f7afdb3
commit 9a145c3
Show file tree

Hide file tree

Showing 12 changed files with 295 additions and 1,114 deletions.
diff --git a/concepts/thesaurus.ttl b/concepts/thesaurus.ttl
@@ -94,7 +94,8 @@ beg-sbb:Source
   skos:definition
     "«heeft bron» relateert een begrip aan een brondocument waarvan het is afgeleid."@nl ,
     "Source relates a concept to a document from which it is derived."@en ;
-  skos:scopeNote "Deze eigenschap ia alleen bedoeld is voor bronnen die definieerd zijn voor het begrip.Als je andere bronnen wilt relateren aan het begrip, dan moet je een andere/eigen eigenschap gebruiken.";
+  skos:scopeNote
+    "Deze eigenschap is alleen bedoeld om te verwijzen naar brondocumenten waarop de betekenis van het begrip is gebaseerd. Als je naar bronnen met een andere functie wilt verwijzen, dan moet je een andere/eigen eigenschap gebruiken.";
   dct:source
     dct: ,
     <https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#http://purl.org/dc/terms/source> ;
@@ -176,7 +177,7 @@ beg-sbb:Broader
     "«has broader» relates a concept to a concept that is more general in meaning."@en ,
     "«heeft bovenliggend begrip» relateert een begrip aan een begrip met een meer algemene betekenis."@nl ;
   skos:scopeNote 
-    "Conventie is om «heeft bovenliggend begrip» alleen te gebruiken om een directe hiërarchische link tussen twee begripen te beschrijven."@nl, 
+    "Conventie is om «heeft bovenliggend begrip» alleen te gebruiken om een directe hiërarchische link tussen twee begrippen te beschrijven."@nl, 
     "By convention, «has broader» is only used to assert an immediate (i.e. direct) hierarchical link between two conceptual resources."@en;
   dct:source
     <https://www.iso.org/obp/ui/#iso:std:iso:25964:-1:ed-1:v1:en:sec:2.12> ,
@@ -734,10 +735,10 @@ beg-sbb:SourceDocument
     "brondocument"@nl ;
   skos:altLabel "bron"@nl ;
   skos:definition
-    "Een brondocument is een document of resource op het web waaruit de betekenis van een begrip is afgeleid."@nl ,
-    "A source document is a document or web resource from which a described concept is derived."@en ;
+    "Een brondocument is een document of resource op het web die relevant is voor een begrip."@nl ,
+    "A source document is a document or web resource that is relevant for a concept."@en ;
   skos:scopeNote 
-    "De bron kan een geschreven bron zijn of een resource op het web. Aanbevolen best practice is om de bron te beschrijven door middel van een tekenreeks die voldoet aan een formeel identificatiesysteem. Bij een resource op het web is ook de uri van die bron relevant. Om zowel naar een geschreven bron als naar een bron op het web (vaak zonder gestandaardiseerde beschrijving) te verwijzen wordt een hulp-resource gedefinieerd, die zowel een gestandaardiseerde beschrijving als een verwijzing naar de eigenlijke bron bevat."@nl,
+    "De brondocument kan een geschreven document zijn of een resource op het web. Aanbevolen best practice is om het brondocument te beschrijven door middel van een tekenreeks die voldoet aan een formeel identificatiesysteem. Bij een resource op het web is ook de uri van het document relevant."@nl ,
     "The described resource may be derived from the related resource in whole or in part. Recommended best practice is to identify the related resource by means of a string conforming to a formal identification system."@en ;
   dct:source
     dct: ,

diff --git a/config.js b/config.js
@@ -1,12 +1,17 @@
 // All config options at https://respec.org/docs/
-var respecConfig = {
-    // hack to skip W3C specStatus validation
-    latestVersion: "https://profielstelselcatalogus.pldn.nl/",
-    // Working Groups ids at https://respec.org/w3c/groups/
-    group: "webapps",
-    xref: "web-platform",
-    specStatus: "unofficial",
-    maxTocLevel: 5,
+let respecConfig = {
+    useLogo: true,
+    useLabel: true,
+     // title is verplicht! Neem hier de titel van het document op ----------------------
+    title: "SBB - Standaard voor het beschrijven van begrippen",
+    // subtitle is NIET verplicht
+    // subtitle: "Subtitle",
+    specStatus: "cv",               // Consultatieversie
+    specType: "ST",                   // Standaard
+    pubDomain: "sbb",
+    license: "cc-by",
+    shortName: "def-st-mim-20220217",
+    edDraftURI: "https://pldn.github.io/nederlands-profiel-voor-stelselcatalogi/",
     editors: [
         {
             name: "Jesse Bakker"
@@ -71,12 +76,9 @@ var respecConfig = {
             name: "Jan Willem van Veen (ArchiXL)"
         },
     ],
-    github: {
-        branch: "main",
-        repoURL: "pldn/nederlands-profiel-voor-stelselcatalogi",
-    },
-    //  localBiblio: lokale bibliografie, voor verwijzigingen
-    //  NB: kijk eerst naar de beschikbare www.specref.org voor verwijziging
+    github: "pldn/nederlands-profiel-voor-stelselcatalogi",
+    issueBase: "https://github.com/pldn/nederlands-profiel-voor-stelselcatalogi/issues/",
+    maxTocLevel: 5,
     localBiblio: {
         NLAPI: {
             title: "Nederlandse API strategie",
@@ -133,5 +135,26 @@ var respecConfig = {
             date: "1 August 2013"
         },
     lint: { "no-unused-dfns": false },
-    },
+    },    
+
+   // latestVersion: "https://profielstelselcatalogus.pldn.nl/",
+
+
+
+    // Working Groups ids at https://respec.org/w3c/groups/
+    // group: "webapps",
+    // xref: "web-platform",
+    // specStatus: "unofficial",
+
+    //  localBiblio: lokale bibliografie, voor verwijzigingen
+    //  NB: kijk eerst naar de beschikbare www.specref.org voor verwijziging
+
+    // licenses: {
+    //     "cc-by": {
+    //       name: "Creative Commons Attribution 4.0 International Public License",
+    //         short: "CC-BY",
+    //         url: "https://creativecommons.org/licenses/by/4.0/legalcode",
+    //         image: "https://tools.geostandaarden.nl/respec/style/logos/cc-by.svg",
+    //     }
+    //   },
 };
diff --git a/index.html b/index.html
@@ -2,27 +2,32 @@
 <html lang="nl">
 
 <head>
-  <meta charset='utf-8'>
-  <link rel="stylesheet" type="text/css" href="./respec/media/style.css">
-  <link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2016/base.css" class="removeOnSave">
-  <script src='https://www.w3.org/Tools/respec/respec-w3c' async class='remove'></script>
+  <meta content="text/html; charset=utf-8" http-equiv="content-type">
+  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+  <script src="https://cdn.jsdelivr.net/gh/digitalbazaar/respec-mermaid@1.0.1/dist/main.js" class="remove"></script>
+  <!-- <script src="https://tools.geostandaarden.nl/respec/config/geonovum-config.js" class="remove"></script> -->
+  <script src="./respec/sbb-config.js" class="remove"></script>
   <script src="config.js" class="remove"></script>
+  <script class="remove"> respecConfig = {...organisationConfig, ...respecConfig}</script>
+  <script>document.title = respecConfig.title</script>
+  <!-- <link rel="shortcut icon" type="image/x-icon" href="https://tools.geostandaarden.nl/respec/style/logos/Geonovum.ico" /> -->
+  <script src="https://gitdocumentatie.logius.nl/publicatie/respec/builds/respec-nlgov.js" class="remove" async></script>
+  <link rel="stylesheet" type="text/css" href="./respec/media/style.css">
 </head>
-
 <body>
-  <h1 id="title">Nederlandse standaard voor het beschrijven van begrippen</h1>
-  <section id='abstract' data-format="markdown" data-include="respec/Samenvatting.md"></section>
+  <!-- <h1 id="title">Nederlandse standaard voor het beschrijven van begrippen</h1> -->
+  <section id='abstract' data-include-format="markdown" data-include="respec/Samenvatting.md"></section>
   <section id='sotd'></section>
-  <section id='H1' data-format="markdown" data-include="respec/H1-inleiding.md"></section>
-  <section id='H2' data-format="markdown" data-include="respec/H2-conceptuele-beschrijving.md"></section>
-  <section id='H3' data-format="markdown" data-include="respec/H3-toepassingsprofiel-ld.md"></section>
-  <section id='H4' data-format="markdown" data-include="respec/H4-best-practices.md" class="informative"></section>
+  <section id='H1' data-include-format="markdown" data-include="respec/H1-inleiding.md"></section>
+  <section id='H2' data-include-format="markdown" data-include="respec/H2-conceptuele-beschrijving.md"></section>
+  <section id='H3' data-include-format="markdown" data-include="respec/H3-toepassingsprofiel-ld.md"></section>
+  <section id='H4' data-include-format="markdown" data-include="respec/H4-best-practices.md" class="informative"></section>
   <section id='conformance'>
     <!-- This section is filled automatically by ReSpec. -->
   </section>
   <section id="index" class="appendix"></section>
-  <section class="appendix" data-format="markdown" data-include="respec/conventies.md"></section>
-  <!-- <section data-format="markdown" data-include="respec/rdf2markdown/en-woordenboek-table.md" 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> -->
 
 </body>
 

diff --git a/respec/H2-conceptuele-beschrijving.md b/respec/H2-conceptuele-beschrijving.md
@@ -24,7 +24,11 @@ Als een term uit meerdere woorden bestaat ontstaan soms grammaticaal onlogische
 
 ## Overzicht
 Het onderstaande diagram geeft een overzicht van de samenhang tussen een begrippenkader, een begrip en een brondocument met hun eigenschappen en onderlinge relaties. Iedere relatie wordt 1 keer beschreven, als uitgaande relatie. Zo wordt "in kader" beschreven bij "begrip" en niet bij "begrippenkader". 
-![](/respec/media/model-conceptueel.png)
+
+<figure id="conceptueel-model">
+  <img src="/respec/media/model-conceptueel.png" alt="" />
+  <figcaption>Diagram: conceptueel model</figcaption>
+</figure>
 
 ## Begrippenkader
 Begrippen kunnen als zelfstandige entiteiten worden gezien maar veelal worden ze opgesteld als onderdeel van een gecureerd begrippenkader, zoals begrippenlijsten, taxonomieën en thesauri. Een [=begrippenkader=] is een verzameling van [=begrip=]pen die in een bepaalde context relevant zijn. Een begrippenkader wordt ookwel gezien als een eenheid van context. Als kenmerk van het [=begrip=] wordt aangegeven of het onderdeel is van een begrippenkader ([=in kader=]). Een begrippenkader is vergelijkbaar met een taal die in een bepaald gebied gesproken wordt. En net als een reguliere taal is een begrippenkader een open systeem. Zo kan een taal ook groeien na introductie van nieuwe woorden vanuit talen uit nabijgelegen gebieden. Dat wil zeggen dat een begrippenkader, net als een taal, naast vertalingen (mappings) ook leenwoorden kent. Zoals "computer", een van origine Engels woord, ook behoort tot de Nederlandse taal. Het beschrijven van welke begrippen behoren tot een begrippenkader is essentieel; maar hoe deze 'vertaald' kunnen worden naar begrippen uit andere begrippenkaders ook. Voor dit laatste gebruiken we [=harmonisatierelatie=]s.
@@ -59,7 +63,7 @@ Een begrippenkader kan beschreven worden aan de hand van verschillende kenmerken
 Begrip is het centrale element in deze specificatie. Begrippen spelen ook een centrale rol in de manier waarop we communiceren en we de wereld om ons heen begrijpen. 
 Een begrip is een conceptuele resource; het zijn de eenheden van denken, het idee, de betekenis of categorisering. In de communicatiewetenschap wordt hier vaak gerefereerd aan de 'Triangle of meaning'. Hier wordt duidelijk dat bij het gebruik van bepaalde termen een spreker en toehoorder niet noodzakelijk dezelfde gedachte vormen en elkaar dus niet begrijpen. 
 
-![](https://github.com/bp4mc2/bp4mc2/blob/master/site/image-ch3-1.png?raw=true "Triange of meaning")
+![](https://github.com/bp4mc2/bp4mc2/blob/master/site/image-ch3-1.png?raw=true "Triangle of meaning")
 
 Het hebben van gestandaardiseerde begrippen zorgt ervoor dat iedereen dezelfde taal kan spreken en weet wat de bedoelde betekenis is bij het gebruik van een bepaalde [=naam=] in een bepaalde context. Bijvoorbeeld in berichtgeving of in data. Dit maakt het eenvoudiger om effectief te communiceren en informatie uit te wisselen.
 
@@ -110,7 +114,7 @@ Een begrip kan beschreven worden aan de hand van verschillende kenmerken. Deze z
 | **voorkeursterm**   | <dfn>in kader</dfn> |
 | **definitie**        | In kader relateert een begrip aan een begrippenkader waarin het is opgenomen. |
 | **heeft bron** | http://www.w3.org/2004/02/skos/core#, https://www.iso.org/obp/ui/#iso:std:iso:25964:-1:ed-1:v1:en:sec:2.12, https://www.w3.org/TR/2009/REC-skos-reference-20090818/#schemes |
-| **toelichting** | Volgens de SKOS-standaard kan een begrip in meerdere begrippenkaders worden opgenomen. Praktisch gezien kan dit slechts als sprake is van begrippenkaders waarvan de contexten overlappen. |
+| **toelichting** | Volgens de SKOS-standaard kan een begrip in meerdere begrippenkaders worden opgenomen. We bedoelen dan ook niet met deze eigenschap dat een begrip wordt beheerd in dit begrippenkader, maar dat dit begrip valt binnen de context die met het begrippenkader wordt beoogd. Praktisch gezien kan dit slechts als sprake is van begrippenkaders waarvan de contexten overlappen. |
 | **uri** | http://begrippen.nlbegrip.nl/sbb/id/concept/InScheme |
 
 |                       |                                       |
@@ -293,7 +297,7 @@ Als een eerste begrip een bovenliggend begrip is in relatie tot een tweede begri
 | **voorkeursterm**   | <dfn>heeft bovenliggend begrip</dfn> |
 | **definitie**        | «heeft bovenliggend begrip» relateert een begrip aan een begrip met een meer algemene betekenis. |
 | **heeft bron** | http://www.w3.org/2004/02/skos/core#, https://www.iso.org/obp/ui/#iso:std:iso:25964:-1:ed-1:v1:en:sec:2.12, https://www.w3.org/TR/skos-reference/#semantic-relations |
-| **toelichting** | Conventie is om «heeft bovenliggend begrip» alleen te gebruiken om een directe hiërarchische link tussen twee begripen te beschrijven. |
+| **toelichting** | Conventie is om «heeft bovenliggend begrip» alleen te gebruiken om een directe hiërarchische link tussen twee begrippen te beschrijven. |
 | **alternatieve term** | heeft breder begrip |
 | **code** | BT |
 | **uri** | http://begrippen.nlbegrip.nl/sbb/id/concept/Broader |
@@ -443,8 +447,8 @@ Specifiek onderscheiden we de volgende verschillende harmonisatierelaties.
 
 ## Brondocument
 
-Een [=brondocument=] is een document waaruit de betekenis van het begrip is afgeleid.
-Het is een good practice om voor ieder begrip bronverwijzingen op te nemen. Zo is het duidelijk waar de definitie van een begrip op gebaseerd is. Dit verhoogt de kwaliteit van het begrip en vooral ook de betrouwbaarheid. Het gebruiken van de hieronder beschreven structuur wordt ten zeerste aanbevolen voor het beschrijven van bronnen en het relateren van begrippen aan bronnen.
+Een [=brondocument=] is een document die relevant is voor een begrip.
+Het is een good practice om voor ieder begrip een verwijzing naar een brondocument op te nemen. Zo is het duidelijk waar bijvoorbeeld de definitie van een begrip op gebaseerd is. Dit verhoogt de kwaliteit van het begrip en vooral ook de betrouwbaarheid. Het gebruiken van de hieronder beschreven structuur wordt ten zeerste aanbevolen voor het beschrijven van bronnen en het relateren van begrippen aan brondocumenten.
 
 Een bronverwijzing wordt vastgelegd als kenmerk van een begrip. Hiervoor geldt we het volgende patroon:
 
@@ -453,26 +457,27 @@ Een **[=begrip=]** heeft een kenmerk '**[=heeft bron=]**'. Dit kenmerk relateert
 |                       |                                       |
 |-----------------------|---------------------------------------|
 | **voorkeursterm**   | <dfn>heeft bron</dfn> |
-| **definitie**        | «heeft bron«» relateert een begrip aan een brondocument waarvan het is afgeleid. |
+| **definitie**        | «heeft bron» relateert een begrip aan een brondocument waarvan het is afgeleid. |
 | **heeft bron** | http://purl.org/dc/terms/, https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#http://purl.org/dc/terms/source |
-| **alternatieve term** | herkomst, bronverwijzing |
+| **toelichting** | Deze eigenschap is alleen bedoeld om te verwijzen naar brondocumenten waarop de betekenis van het begrip is gebaseerd. Als je naar bronnen met een andere functie wilt verwijzen, dan moet je een andere/eigen eigenschap gebruiken. |
+  | **alternatieve term** | herkomst, bronverwijzing |
 | **uri** | http://begrippen.nlbegrip.nl/sbb/id/concept/Source |
 
 
 |                       |                                       |
 |-----------------------|---------------------------------------|
 | **voorkeursterm**   | <dfn>brondocument</dfn> |
-| **definitie**        | Een brondocument is een document of resource op het web waaruit de betekenis van een begrip is afgeleid. |
+| **definitie**        | Een brondocument is een document of resource op het web die relevant is voor een begrip. |
 | **heeft bron** | http://purl.org/dc/terms/, http://xmlns.com/foaf/0.1/, https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#BibliographicResource, http://xmlns.com/foaf/0.1/#term_Document |
-| **toelichting** | De bron kan een geschreven bron zijn of een resource op het web. Aanbevolen best practice is om de bron te beschrijven door middel van een tekenreeks die voldoet aan een formeel identificatiesysteem. Bij een resource op het web is ook de uri van die bron relevant. Om zowel naar een geschreven bron als naar een bron op het web (vaak zonder gestandaardiseerde beschrijving) te verwijzen wordt een hulp-resource gedefinieerd, die zowel een gestandaardiseerde beschrijving als een verwijzing naar de eigenlijke bron bevat. |
+| **toelichting** | De brondocument kan een geschreven document zijn of een resource op het web. Aanbevolen best practice is om het brondocument te beschrijven door middel van een tekenreeks die voldoet aan een formeel identificatiesysteem. Bij een resource op het web is ook de uri van het document relevant. |
 | **alternatieve term** | bron |
 | **uri** | http://begrippen.nlbegrip.nl/sbb/id/concept/SourceDocument |
 
 Een brondocument kan beschreven worden aan de hand van verschillende kenmerken. Deze zijn in de volgende tabel weergegeven.
 
 | Conceptueel element | Kardinaliteit | Type         |
 | ------------------- | ------------- | ------------ |
-| [=naam=]           | 1..*          | Tekst        |
+| [=naam=]            | 1..*          | Tekst        |
 | [=uitleg=]          | 0..*          | Tekst        |
 | [=url=]             | 0..*          | Url          |
 | [=citeertitel=]     | 0..*          | Tekst        |
@@ -526,7 +531,7 @@ Een collectie kan beschreven worden aan de hand van verschillende kenmerken. Dez
 
 | Conceptueel element | Kardinaliteit | Type                        |
 | ------------------- | ------------- | --------------------------- |
-| [=naam=]           | 1..*          | Tekst                       |
+| [=naam=]            | 1..*          | Tekst                       |
 | [=uitleg=]          | 0..*          | Tekst                       |
 | [=bevat=]           | 0..*          | [=begrip=] of [=collectie=] |