Skip to content
This repository has been archived by the owner on Apr 17, 2024. It is now read-only.

Commit

Permalink
Update editorial/consultation issues
Browse files Browse the repository at this point in the history
  • Loading branch information
Bakkej committed Feb 15, 2024
1 parent 7c173b0 commit fcf35c2
Show file tree
Hide file tree
Showing 14 changed files with 578 additions and 294 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ De werkversie van het profiel is te vinden op [https://profielstelselcatalogus.p

De PLDN Werkgroep ‘Nederlands profiel voor stelselcatalogi’ als ambitie een basisprofiel voor stelselcatalogi met elkaar te beschrijven, waarmee verschillende stelselcatalogi interoperabel ingericht kunnen worden. De bedoeling is dat catalogi gemakkelijk naar elkaars begrippen kunnen verwijzen. Daarmee ontstaat en soort van samenhangend stelsel van stelselcatogi, waarbij ieder stelsel een samenhangend domein representeert. Voorbeelden zijn de [stelselcatalogus voor de basisregistraties](https://www.stelselcatalogus.nl/) (de moeder van alle catalogi), de [stelselcatalogus voor het DSO](https://stelselcatalogus.omgevingswet.overheid.nl/) en de [stelselcatalogus voor het Zorgeloos Vastgoed Stelsel](https://taxonomie.zorgeloosvastgoed.nl/). Naast het basisprofiel zullen meerdere extensies ontstaan. Dit kunnen extensies zijn om tot een volledige ISO compatable thesaurus te komen, maar ook extensies die relevant zijn voor een specifiek domein. Er lijkt in Nederland op dit moment echt momentum om dit gezamenlijk op te pakken en naar semantisch interoperabele publiek-private domeinen toe te werken.

We richten ons in eerste instantie op een good practice voor het beschrijven van een begrippenkader met begrippen ofwel concepten. We zien begrip en concept als synoniem. Daarbij zullen we aandacht besteden aan de verschillende niveaus van detaillering voor het beschrijven van concepten. Dit begint met het minimaal beschrijven van een concept met een term en een definitie, waarbij we naast een formele definitie ook een publieksvriendelijke variant op taalniveau B2 willen hebben. Door hiërarchische relaties toe te voegen ontstaat een taxonomie en door nog meer verbanden tussen concepten toe te voegen ontstaat een thesaurus. In sommige gevallen willen we wellicht zelfs nog wat meer semantiek toevoegen zoals het nader duiden van subjecten, handelingen en objecten (onderwerp, lijdend voorwerp, gezegde). Dit willen we stap voor stap afpellen. We starten met techniekonafhankelijke principes voor het beschrijven van een begrippenkader. Uiteindelijk willen we komen tot een gedeelde standaard voor het beschrijven van zo’n begrippenkader. Deze standaard beschrijft hoe wij bestaande W3C standaarden toepassen. Voor begrippenkaders gaat het daarbij onder andere om rdfs, skos, dcterms, prov-o en adms /dcat. Ons doel is om het uiteindelijke profiel als aanbevolen standaard of wellicht zelfs als pas-toe-leg-uit standaard aan te bieden aan het Forum Standaardisatie.
We richten ons in eerste instantie op een good practice voor het beschrijven van een begrippenkader met begrippen ofwel concepten. We zien begrip en concept als synoniem. Daarbij zullen we aandacht besteden aan de verschillende niveaus van detaillering voor het beschrijven van concepten. Dit begint met het minimaal beschrijven van een concept met een term en een definitie, waarbij we naast een formele definitie ook een publieksvriendelijke variant op taalniveau B2 willen hebben. Door hiërarchische relaties toe te voegen ontstaat een taxonomie en door nog meer verbanden tussen concepten toe te voegen ontstaat een thesaurus. In sommige gevallen willen we wellicht zelfs nog wat meer semantiek toevoegen zoals het nader duiden van subjecten, handelingen en objecten (onderwerp, lijdend voorwerp, gezegde). Dit willen we stap voor stap afpellen. We starten met techniekonafhankelijke principes voor het beschrijven van een begrippenkader. Uiteindelijk willen we komen tot een gedeelde standaard voor het beschrijven van zo’n begrippenkader. Deze standaard beschrijft hoe wij bestaande W3C standaarden toepassen. Voor begrippenkaders gaat het daarbij onder andere om rdfs, skos, dcterms, prov-o en adms/dcat. Ons doel is om het uiteindelijke profiel als aanbevolen standaard of wellicht zelfs als pas-toe-leg-uit standaard aan te bieden aan het Forum Standaardisatie.

Naast een begrippenkader kent een stelselcatalogus ook een beschrijving van de gegevens in die registratie en soms ook een overzicht van waardelijsten met referentiegegevens of classificaties. Hier zal ook het [MIM](https://www.geonovum.nl/geo-standaarden/metamodel-informatiemodellering-mim) (Metamodel voor InformatieModellelering) belangrijke input vormen.

Expand Down
199 changes: 87 additions & 112 deletions concepts/thesaurus.ttl

Large diffs are not rendered by default.

100 changes: 98 additions & 2 deletions config.js
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ let respecConfig = {
title: "SBB - Standaard voor het beschrijven van begrippen",
// subtitle is NIET verplicht
// subtitle: "Subtitle",
specStatus: "cv", // Consultatieversie
specStatus: "vv", // Versie ter vaststelling
specType: "ST", // Standaard
pubDomain: "sbb",
license: "cc-by",
Expand Down Expand Up @@ -164,7 +164,6 @@ let respecConfig = {
id: "vocab-adms-asset",
date: "1 August 2013"
},
lint: { "no-unused-dfns": false },
},
alternateFormats: [
{
Expand All @@ -176,6 +175,103 @@ let respecConfig = {
uri: "https://raw.githubusercontent.com/pldn/nederlands-profiel-voor-stelselcatalogi/main/concepts/thesaurus.ttl",
},
],
labelColor: {
def: "#045D9F",
wv: "#FF0000",
cv: "#045D9F",
vv: "#045D9F",
basis: "#80CC28",
},

licenses: {
"cc0": {
name: "Creative Commons 0 Public Domain Dedication",
short: "CC0",
url: "https://creativecommons.org/publicdomain/zero/1.0/",
image: "https://tools.geostandaarden.nl/respec/style/logos/CC-Licentie.svg",
},
"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",
},
"cc-by-nd": {
name: "Creative Commons Naamsvermelding-GeenAfgeleideWerken 4.0 Internationaal",
short: "CC-BY-ND",
url: "https://creativecommons.org/licenses/by-nd/4.0/legalcode.nl",
image: "https://tools.geostandaarden.nl/respec/style/logos/cc-by-nd.svg",
},
},
nl_organisationName: " ",
nl_organisationPublishURL: "https://profielstelselcatalogus.pldn.nl",
latestVersion: ["nl_organisationPublishURL", "pubDomain", "/", "shortName", "/"],
thisVersion: ["nl_organisationPublishURL", "pubDomain", "/", "specStatus", "-", "specType", "-", "shortName", "-", "publishDate"],
prevVersion: ["nl_organisationPublishURL", "pubDomain", "/", "previousMaturity", "-", "specType", "-", "shortName", "-", "previousPublishDate"],
useLogo: true,
useLabel: true,

license: "cc-by",
addSectionLinks: true,

localizationStrings: {
en: {
wv: "Editor's draft",
cv: "Candidate recommendation",
vv: "Proposed recommendation",
def: "Recommendation",
basis: "Document",
//eo: "Outdated version",
//tg: "Rescinded version",
no: "Norm",
st: "Standard",
im: "Information model",
pr: "Practical guideline",
hr: "Guide",
wa: "Work process agreement",
al: "General",
bd: "Governance documentation",
bp: "Best practice",
},
nl: {
wv: "Werkversie",
cv: "Consultatieversie",
vv: "Versie ter vaststelling",
def: "Vastgestelde versie",
basis: "Document",
//eo: "Verouderde versie",
//tg: "Teruggetrokken versie",
no: "Norm",
st: "Standaard",
im: "Informatiemodel",
pr: "Praktijkrichtlijn",
hr: "Handreiking",
wa: "Werkafspraak",
al: "Algemeen",
bd: "Beheerdocumentatie",
bp: "Best practice",
},
},

sotdText: {
nl: {
sotd: "Status van dit document",
def: `Dit is de definitieve versie van dit document. Wijzigingen naar aanleiding van consultaties zijn doorgevoerd.`,
wv: `Dit is een werkversie die op elk moment kan worden gewijzigd, verwijderd of vervangen door andere documenten. Het is geen stabiel document.`,
cv: `Dit is een consultatieversie. Commentaar over dit document kan gestuurd worden naar []`,
vv: `Dit is de definitieve conceptversie van dit document. Wijzigingen naar aanleiding van consultaties zijn doorgevoerd.`,
basis: "Dit is een document zonder officiële status.",
},
en: {
sotd: "Status of this document",
def: `This is the definitive version of this document. Edits resulting from consultations have been applied.`,
wv: `This is a working draft that can be changed, removed or replaced by other documents at any time. It is not a stable document.`,
cv: `This is a stable draft, published for public comment. Comments regarding this document may be sent to `,
vv: `This is the final draft of this document. Edits resulting from consultations have been applied.`,
basis: "This document has no official standing.",
},
},

// latestVersion: "https://profielstelselcatalogus.pldn.nl/",


Expand Down
12 changes: 7 additions & 5 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<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="./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>
Expand All @@ -18,10 +18,12 @@
<!-- <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-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='H1' data-include-format="markdown" data-include="respec/H1-inleiding.md" class="informative"></section>
<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='H5' data-include-format="markdown" data-include="respec/H5-best-practices.md" class="informative"></section>
<section id='H6' data-include-format="markdown" data-include="respec/H6-uitbreidingen.md" class="informative"></section>
<section id='conformance'>
<!-- This section is filled automatically by ReSpec. -->
</section>
Expand Down
Loading

0 comments on commit fcf35c2

Please sign in to comment.