Skriv for Aksel
Aksel er avhengig av at folkene som sitter tett på produktutviklingen i NAV bidrar med innhold om god praksis. Her finner du det du trenger å vite for å bli en god Aksel-skribent.
Før du skriver
- Ta kontakt med temaredaktør for å planlegge innholdet
- Les om Aksel og sett deg inn i innholdsprinsippene. Innholdet skal i korte trekk:
- dekke tverrfaglige produktteams behov
- være levende og praktisk
- være tilpasset konteksten til tverrfaglige produktteam i NAV - bruk eksempler
- invitere til dialog. Alt innhold skal ha en avsender slik at kollegaer enkelt kan komme i kontakt med den som har skrevet artikkelen.
Når du skriver
Språkstilen vi bruker i Aksel skal være enkel, vennlig og tilgjengelig:
- Bruk et aktivt språk og personlige pronomen som «du» og «vi»
- Bruk gjerne et hverdagslig språk og unngå komplisert fagterminologi
- Sett de viktigste nøkkelordene langt frem i teksten
- Skriv hele, korte setninger
- Skriv gode og meningsbærende overskrifter og mellomtitler
- Skap kontraster i teksten med for eksempel punktlister, tipsbokser og accordions
- Skriv til en kollega som kan mindre om stoffet enn deg selv
- Bruk eksempler for å forklare slik at budskapet ditt blir enklere å forstå
Det er god praksis å få en kollega eller to til å lese teksten før publisering for å sjekke om teksten er forståelig og svarer på brukeroppgavene.
Test teksten på en kollega i målgruppa. Les om lavterskel brukertesting av tekst.
Bruk NAV språkhjelp for å få hjelp til å gjøre teksten din mer lettlest.
Når du redigerer innholdet i Sanity
Aksel ligger i Sanity, som er et headless CMS med god redaktøropplevelse. Les om hvordan du logger inn og publiserer i Sanity. Følg disse tipsene for at innholdet du publiserer har god kvalitet og er universelt utformet:
- URL blir automatisk generert basert på tittelen. Du kan gjerne forkorte den for å gjøre den mer lesbar.
- Når du lenker til andre sider, må du skrive en lenketekst som er beskrivende for lenkens mål.
- Hvis du bruker bilder, må du legge inn alt-tekst som fungerer som et reelt alternativ for bildet.
- Sørg for at overskriftsnivåene er i sammenhengende rekkefølge (H2 > H3 er OK, H2 > H4 er ikke OK).
- Bruk verktøyene i Sanity for å lage tabeller og lister, fremfor å mekke en egen løsning
- Legg til alle som har bidratt til innholdet i feltet for redaktører. Den som står først vil stå som forfatter øverst i artikkelen, mens resten vil stå som bidragsytere nederst.
- Forhåndsvisningen for siden du jobber med blir automatisk oppdatert når du redigerer innholdet i Sanity. Vi anbefaler at du åpner forhåndsvisning/preview og har både denne og editor-siden åpen, slik at du kan se hvordan innholdet blir seende ut.
Når du er fornøyd med teksten og har lagt den inn i Sanity, avtaler du publisering med temaredaktør. Du publiserer innholdet, men innholdet blir ikke synlig på temasiden før temaredaktøren legger det til der.
Etter du har publisert
God praksis-innholdet på Aksel skal være levende og relevant, og må derfor oppdateres når det er behov for det. Du som har skrevet innholdet har ansvar for å oppdatere innholdet når det er behov og sikre at det fortsatt er relevant.
Vi har noen mekanismer som er med på å gjøre denne jobben lettere:
- Etter 12 mnd regnes en god praksis-artikkel som "utdatert" i systemet. For designsystem-artikler er det 6 mnd.
- Du vil da finne artikkelen under en egen mappe som heter "Mine artikler som trenger oppdatering" under god praksis mappen i sanity.
- Alle artikler vil ha en banner i toppen som varsler om at artikkelen trenger en oppdatering.
- Gå gjennom artikkel og verifiser at alt fortsatt stemmer, evt oppdatere innhold der det trengs.
- Trykk "Godkjenn innhold"-knappen for å publisere endringer og oppdatere "sist godkjent"-verdien.
Du finner flere skriveråd i artikkelen: Slik skriver vi i NAV