Skip to content
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

Open
wants to merge 6 commits into
base: develop
Choose a base branch
from
Open

Aaanpassing na proof-reading #25

wants to merge 6 commits into from

Conversation

TheBonheurs
Copy link
Member

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!

wisze

This comment was marked as outdated.

Copy link
Contributor

@wisze wisze left a 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
Copy link
Contributor

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

Copy link
Member Author

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>;
Copy link
Contributor

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)

Copy link
Member Author

@TheBonheurs TheBonheurs Oct 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De markdown links worden niet goed gerenderd (waarschijnlijk vanwege het aside block) op mijn browser (edge Version 127.0.2651.98, werklaptop).

image

Copy link
Member

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>:

<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>

Copy link
Member Author

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**
Copy link
Contributor

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?

Copy link
Member Author

@TheBonheurs TheBonheurs Oct 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

De formattering is verschillend bij deze kopjes, de spaties (aanvullen tot tab) zorgen ervoor dat de titels op aparte regels, los van de tekst staan.
Als dit niet wenselijk is, dan is dat ook goed. Eenduidige formatting zou wel fijn zijn denk ik.

Copy link
Member

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

ch04_Het_Beheer_en_Ontwikkelmodel.md Outdated Show resolved Hide resolved
@@ -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:
Copy link
Contributor

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.

Copy link
Member Author

@TheBonheurs TheBonheurs Oct 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

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.

ch04_Het_Beheer_en_Ontwikkelmodel.md Show resolved Hide resolved
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.
Copy link
Contributor

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?

Copy link
Member Author

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

ch05_Deel2.md Show resolved Hide resolved
ch05_Deel2.md Show resolved Hide resolved
ch05_Deel2.md Show resolved Hide resolved
@TheBonheurs TheBonheurs requested a review from wisze October 7, 2024 12:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants