-
Notifications
You must be signed in to change notification settings - Fork 3
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Aaanpassing na proof-reading #25
base: develop
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Een paar opmerkingen op deze pull.
@@ -115,7 +115,7 @@ die disciplines kunnen bruikbaar zijn. Met name het BiSL-raamwerk voor | |||
functioneel beheer is in enige mate bruikbaar, en deze is dan ook | |||
meegenomen in de totstandkoming van BOMOS (Voor meer informatie over | |||
BiSL: Best Practice - BiSL – Een framework voor Functioneel Beheer en | |||
Informatiemanagement , Remko van der Pols, Ralph Donatz, Frank van | |||
Informatiemanagement, Remko van der Pols, Ralph Donatz, Frank van |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
geen spatie voor een comma
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Snap hem even niet, moet er wel een spatie voor de komma in dit geval?
@@ -103,8 +103,8 @@ De standaard NL-LOM beschrijft op welke | |||
manier metadata moet worden vastgelegd bij educatief materiaal. Een | |||
voorziening dat gebruik maakt van NL-LOM is Edurep, een zoekmachine | |||
die op basis van metadata educatief materiaal vindbaar maakt. | |||
([NL-LOM](https://www.forumstandaardisatie.nl/standaard/nl-lom); | |||
[Edurep](https://www.kennisnet.nl/edurep/)) | |||
(<a href=https://www.forumstandaardisatie.nl/standaard/nl-lom>NL-LOM</a>; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We houden in de markdown files markdown syntax aan voor hyperlinks, het is geen html (maar het gebruikt wel hier en daar html)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Er is een lege regel nodig om terug te schakelen naar Markdown. Voorbeeld van MD-stijl-link in <aside>
:
BOMOS-Fundament/ch03_BOMOS_gebruiken.md
Lines 76 to 80 in 956b728
<aside class="example" title="De Thesaurus en Ontologie voor OverheidsInformatie"> | |
TOOI (Thesaurus en Ontologie voor OverheidsInformatie) is een model van de informatie die gepubliceerd wordt door alle organisaties binnen de Nederlandse overheid. Met behulp van het TOOI-model kan die informatie in samenhang vindbaar gemaakt worden over organisaties en informatiesystemen heen. | |
Het TOOI-beheerplan beschrijft hoe de specificaties van TOOI worden beheerd. Het omvat zowel de beheerorganisatie als het huishoudelijk reglement. Het beheerplan TOOI is opgezet volgens de principes uit BOMOS. De invulling van de 5 thema’s uit BOMOS (Strategie, Tactiek, Operationeel, Implementatie Ondersteuning en Communicatie) zijn uitgebreid beschreven op de [website](https://standaarden.overheid.nl/tooi/beheerplan). | |
</aside> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
zo beter?
@@ -154,13 +154,13 @@ ontstaat. | |||
Beheer en ontwikkeling, in de brede zin, voor een standaard bevat ook | |||
onderwerpen als adoptie en certificering. | |||
|
|||
**Beheer- en Ontwikkelmodel** | |||
**Beheer- en Ontwikkelmodel** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Waarom spaties na een titel?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Dit zijn definities, niet kopjes (vandaar geen haakjes).
Een WCAG-verantwoorde manier van definities aangeven is met <dfn>
.
https://respec.org/docs/#definitions-and-linking
@@ -61,7 +61,7 @@ gaat hier verder op in. | |||
|
|||
Onder de genoemde activiteiten verstaan we het volgende: | |||
|
|||
**Strategie**: Richtinggevende activiteiten gerelateerd aan de strategische (lange) termijn: | |||
**Strategie**, Richtinggevende activiteiten gerelateerd aan de strategische (lange) termijn: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Die dubbele punt hoort daar gewoon. Het is niet Strategie of een richtingevende activiteit.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Waarom is er voor gekozen om de kopjes Tactiek en Operationeel met komma te scheiden en niet met dubbelepunt?
Ik streef nog steeds naar een eenduidig format met deze change.
Overigens, als de keuze toch op ":" valt dan staan er 2 dubbelepunten op 1 regel, wat het lezen niet makkelijker maakt naar mijn mening.
informatica - Ontwikkelen en beheren van standaarden en stelsels van | ||
standaarden", en is hier in licht aangepaste versie overgenomen. | ||
standaarden"](https://www.nen.nl/nen-7522-2021-nl-283706), en is hier in licht aangepaste versie overgenomen. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok, maar waarom hier wel een markdown link en hiervoor niet?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Omdat deze niet in een aside block staat en wel goed rendert
Dit zijn de aanpassingen waarvan ik vrij zeker ben dat dit oorspronkelijk de bedoeling was van de onderliggende tekst. Denk aan punctuatie, niet werkende links en standaardisatie van formaten.
Verder heb ik wat dubieuzere comments en opmerkingen verzameld in een word bestand die ik op den duur wil bespreken met het team (gaat meer op de taal en inhoud).
Graag hoor ik van de betrokkenen of jullie het mee eens zijn met deze aanpassingen!