Confluence hos NAV
NAV IKT har en stor systemportefølje bestående av flere hundre applikasjoner. Ansvaret for utvikling og forvaltning av systemporteføljen skifter jevnlig. Dette stiller store krav til at dokumentasjonen må være komplett og lett å finne frem i for nye brukere og forskjellige brukergrupper.
Medarbeidere og leverandører i NAV brukte mye tid på å søke seg frem i dokumentasjonen, som var både uoversiktlig og lite enhetlig. Produksjon av ny dokumentasjon ble ekstra ressurskrevende fordi det ikke fantes en standard alle fulgte, med det resultatet av ny dokumentasjon ofte ble mangelfull og med svært variabel kvalitet.
Vi fikk i oppdrag å implementere en metodikk til Confluence som stiller krav til innhold, struktur og søkbarhet, med fokus på aktiv informasjonsdeling. Målet var å sørge for at Confluence alltid inneholder oppdatert og lett tilgjengelig informasjon.
Resultat
Vi innførte et system for enhetlig forvaltning av maler, som sikrer at brukerne alltid tar utgangspunkt i siste godkjente versjon av en mal. Det som tidligere var tilgjengelig gjennom store Word-maler, er nå brutt opp i mindre maler som kan brukes hver for seg. En stor gevinst med dette er økt søkbarhet, at det er lettere å håndtere endringer på maler og at det går raskere å oppdatere dokumentasjon. En egenutviklet utvidelse til Confluence sørger for at brukerne benytter seg av korrekt struktur og navngiving, med innhold i henhold til publiserte maler.
Vårt system er tatt i bruk på systemdokumentasjonen til over 125 applikasjoner. All systemdokumentasjon er i dag basert på 30 maler, der en mal representerer et kapittel. Tekniske og funksjonelle arkitekter kan løpende godkjenne dokumentasjonen på kapittelnivå, og enkelt få oversikt over statusen for alle delene i et system. De tre hovedresultatene var:
De tre hovedresultatene var
Confluence er nå en portal for all dokumentasjon av systemløsninger
Dokumentene bygges opp etter en forhåndsdefinert sidestruktur
Løsningen gir presise treff i søk
Godkjenningsrapport for all produsert dokumentasjon
Automatisk produksjon av leveransenotater
Oversikt gjenstående arbeid
Maler forvaltes ett sted
Dokumentasjon opprettes gjennom sentralt konfigurerte menyvalg
Teknologi vi brukte
- Confluence
- AUI – Atlassian User Interface
- Java
- jQuery
- AJAX
- REST/JSON
- Velocity
- Closure Templates
Vi gjorde
- Funksjonelt design
- Løsningsarkitektur
- Utvikling
- Brukerstøtte
- Opplæring inkl. kurs