Help:Algemene richtlijnen

Algemene richtlijnen bij het vullen van de repository:

Kies korte betekenisvolle namen voor pagina's; zij zijn het directe toegangspunt tot de informatie
Denk goed na over hoe specifiek de naam is; als je de naam te algemeen kiest is de kans groot dat dat later naamgevingsconflicten oplevert
De naam van een concept hoeft standaard niet ingevuld te worden; deze is gelijk aan de naam van de pagina
Voeg alleen concepten en relaties toe die zijn benoemd in het meta-model; anders wordt de repository snel ontoegankelijk
Sla geen concepten in het meta-model over; anders is het lastig om later standaard queries te formuleren
Vul zoveel mogelijk ook de vrije tekst in, al is het maar met algemene informatie (b.v. van WikiPedia); dit geeft meer betekenis en achtergrond aan de informatie
Gebruik in vrije tekst het QuoteSimple sjabloon om letterlijk gekopieerde tekst op te nemen; hierdoor is duidelijk waar de tekst vandaan komt
Gebruik zoveel mogelijk ArchiMate voor het visueel illustreren van elementen en hun samenhang; hierdoor wordt misinterpretatie van begrippen voorkomen
Gebruik voor opsommingen bullets (*); hierdoor is het helder dat het een opsomming is
Gebruik voor lijsten van onderdelen (b.v. subcomponenten) definition lists (; <naamelement><CR>: <omschrijving>); dit geeft een standaard en overzichtelijke structuur
Gebruik voor kopjes in de vrije tekst level 3 kopjes (===); dit geeft een consistent uiterlijk aan pagina's