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.

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.