Nauwkeurigheid:

* Feitelijke juistheid: De gepresenteerde informatie moet waar en actueel zijn. Verouderde of onjuiste informatie is erger dan geen documentatie.

* Consistentie: De documentatie moet overal consistente terminologie, stijl en opmaak gebruiken.

Volledigheid:

* Omvat alle relevante aspecten: Bevat alle noodzakelijke informatie zodat het beoogde publiek het gedocumenteerde onderwerp kan begrijpen en gebruiken. Dit kan de installatie, het gebruik, het oplossen van problemen, beperkingen en gerelateerde concepten omvatten.

* Voldoende details: Biedt voldoende details om behulpzaam te zijn, waarbij onnodige beknoptheid of overweldigende breedsprakigheid wordt vermeden. Het detailniveau moet geschikt zijn voor de doelgroep.

Begrijpelijkheid:

* Duidelijkheid en beknoptheid: Gebruikt duidelijke en eenvoudige taal en vermijdt jargon of technische termen tenzij dit absoluut noodzakelijk is (en definieert deze vervolgens).

* Logische organisatie: Informatie wordt op een logische en gemakkelijk te volgen manier gepresenteerd, vaak met behulp van kopjes, subkoppen en visuele hulpmiddelen.

* Goed gestructureerd: Gemakkelijk te navigeren en specifieke informatie snel te vinden (bijvoorbeeld via indexen, inhoudsopgaven, zoekfunctionaliteit).

* Aangepastheid voor het publiek: Geschreven op een begripsniveau dat geschikt is voor de doelgroep (beginner, gemiddeld, expert).

Onderhoudbaarheid:

* Eenvoudig te updaten: De documentatie moet gemakkelijk bij te werken zijn en actueel blijven naarmate het gedocumenteerde onderwerp evolueert. Het gebruik van een versiebeheersysteem wordt sterk aanbevolen.

* Modulair en herbruikbaar: Onderdelen van de documentatie kunnen in verschillende contexten worden hergebruikt.

* Gebruikt een beheersbaar formaat: Het kiezen van het juiste formaat (bijvoorbeeld Markdown, reStructuredText, een wiki) is belangrijk voor het gemak van bewerken en weergeven.

Andere belangrijke aspecten:

* Toegankelijkheid: De documentatie moet toegankelijk zijn voor mensen met een handicap, volgens de toegankelijkheidsrichtlijnen.

* Voorbeelden en illustraties: Het gebruik van voorbeelden, diagrammen, schermafbeeldingen en andere visuele hulpmiddelen kan het begrip aanzienlijk verbeteren.

* Zoekfunctionaliteit: Als de documentatie groot is, is het bieden van een robuuste zoekfunctie cruciaal.

* Versiebeheer: Duidelijke vermelding van de versie van het gedocumenteerde onderwerp.

Kortom, goede documentatie anticipeert op de behoeften van de gebruikers en helpt hen bij het succesvol uitvoeren van hun taken. Het is een investering die zich terugbetaalt in lagere ondersteuningskosten, grotere gebruikerstevredenheid en snellere acceptatie van het gedocumenteerde product of systeem.