Om skriving, språk og formatering#
Om skriving#
En leser som opplever teksten som ryddig og forutsigbar, får som regel et bedre inntrykk av innholdet. Dokumentet bør derfor være skrevet og strukturert på en måte som er lett å følge. Hvis strukturen avviker fra det leseren forventer, bør avviket forklares tydelig tidlig.
Generelle huskepunkter for skrivingen:
Gi leseren forutsigbarhet. Det gjør innholdet lettere å ta inn.
Start kapitler med en kort introduksjon som forklarer hva kapitlet inneholder og hvorfor det er relevant.
Bruk gjerne repeterende strukturer i like avsnitt og kapitler.
Jo lettere teksten er å lese, desto lettere er den å forstå.
Språk#
Språknivået bør være slik at teksten kan leses av et bredt publikum, samtidig som det forutsettes noe faglig bakgrunn.
Språket bør være nøytralt og tydelig. Unngå oppblåst språk og utropstegn.
Skriv i passivform, med mindre det unntaksvis er viktig å tydeliggjøre hvem som utfører handlingen.
Unngå pronomen som
jeg,vi,oss,han,hunogman. Bruk entenen, eller omformuler setningen slik at pronomen unngås.Hvis personspesifikke pronomen må brukes, kan
henvære et godt alternativ tilhanellerhun.
Formatering#
Bruk oversiktlig og kjent formatering. Det gjør teksten mer komfortabel å lese.
Sørg for konsekvent formatering (font, skriftstørrelse, avsnittsskiller).
Benytt underkapitler der det er hensiktsmessig for å øke lesbarheten.
Kapitler og underavsnitt bør være nummerert, men vær varsom med mer enn tre nummererte nivåer. Hvis et fjerde nivå trengs, kan det gjerne være unummerert.