Confluence at NAV

NAV IKT (The Norwegian Labour and Welfare Administration ICT) has a large system portfolio consisting of several hundred applications. The responsibility for developing and managing the system portfolio changes regularly. This places strict demands on complete documentation and easy navigation for users and various user groups.

Employees and vendors at NAV spent much time searching through the documentation, which was unclear and not very consistent. Production of new documentation was especially resource-demanding due to lack of a common standard for everyone to follow. Consequently, the new documentation was often incomplete and of variable quality.

Our assignment was to implement a methodology for Confluence that makes demands on contents, structure, and searchability, focusing on active information sharing. The objective was to ensure that Confluence always contains updated and easily accessible information.

Result

We introduced a system for uniform management of templates, ensuring that the users, as a starting point, always use the latest approved version of a template. What was previously available in large Word templates is now divided into smaller templates that can be used separately.  This is a huge gain in that it involves increased searchability, more easily manageable changes to templates and faster documentation updates. A self-developed extension to Confluence ensures that the users make use of correct structure and naming, with contents in accordance with published templates.

Our system is adopted for system documentation for over 125 applications. All system documentation is currently based on 30 templates, a template representing a chapter. Technical and functional architects can continually approve the documentation on chapter level, and easily get an overview of status of all elements in a system.

The three main results were

Confluence is now a portal for all system solutions documentation

The documents are built up following a predefined page structure

The solution gives accurate hits in search

Approval report for all produced documentation

Automatic production of deliverable notes

Overview of remaining tasks

Templates are managed in one location

Documentation created through centrally configured menu options

Technology we used

  • Confluence
  • AUI – Atlassian User Interface
  • Java
  • jQuery
  • AJAX
  • REST/JSON
  • Velocity
  • Closure Templates

What we did

  • Functional design
  • Solution architecture
  • Development
  • User support
  • Training including courses

Want to know more?

Please fill out our contact form