Digdir

Klarspråkveileder Workshop Template

Improving the Deployment Experience

Turning Digdir’s static PDF into a collaborative workshop tool

Altinn Studio is a platform used by public sector teams to build and publish digital services.

This case shows how I worked to improve the deployment experience — a step that technically existed, but was often forgotten or misunderstood.

Turning Digdir’s static PDF into a collaborative workshop tool

TL;DR

Digdir’s plain language guidelines were methodologically strong, but existed only as a static PDF. Teams were already trying to use them digitally — without a shared way of working.

My role was to translate the guidelines into a workshop-ready Miro template that supports collaboration, reduces cognitive load, and is easy to facilitate from day one.

Digdir’s plain language guidelines were methodologically strong, but existed only as a static PDF. Teams were already trying to use them digitally — without a shared way of working.


My role was to translate the guidelines into a workshop-ready Miro template that supports collaboration, reduces cognitive load, and is easy to facilitate from day one.

CASE OVERVIEW

CASE OVERVIEW

ORGANISATION

Digdir

Digdir

Digdir

PRODUCT

Klarspråkveilederen

Klarspråkveilederen

Klarspråkveilederen

FORMAT

PDF → Workshop material

PDF → Workshop material

PDF → Workshop material

ROLE

UX Designer

UX Designer

UX Designer

COLLABORATION

Content designer

Content designer

Content designer

PROCESS

Sprint-inspired approach (Jake Knapp)

Sprint-inspired approach (Jake Knapp)

Sprint-inspired approach (Jake Knapp)

STATUS

In use internally

In use internally

In use internally

WHY: THE PROBLEM

The challenge was not adoption, teams were already trying to use the guidelines in practice.

The problem was the format.

IN WORKSHOPS:
  • the PDF was copied into Miro and surrounded by sticky notes

  • instructions had to be read aloud and interpreted

  • facilitators became “teachers” instead of supporters

  • outputs were messy and hard to reuse

The methodology was solid, but the interaction model was accidental — not designed for collaboration.

The methodology was solid, but the interaction model was accidental — not designed for collaboration.

Conceptual illustration of teams attempting to use the guidelines collaboratively without a shared structure.

Conceptual illustration of teams attempting to use the guidelines collaboratively without a shared structure.

HOW: UNDERSTANDING REAL USER BEHAVIOR

By observing real workshops and talking with designers and facilitators, a clear pattern emerged:

  • teams needed something they could work in, not just read

  • participants needed clarity without heavy explanations

  • facilitators needed structure without scripts

The core problem was not content quality, but how the content shaped behaviour during collaboration.

Observed collaboration patterns when the guidelines were used without a designed structure.

Observed collaboration patterns when the guidelines were used without a designed structure.

REFRAMING THE CHALLENGE

Rather than “digitising a PDF”, the task became:

How might we turn plain language from a document into a collaborative practice?

How might we turn plain language from a document into a collaborative practice?

To keep the work focused and time-bound, I followed a Sprint-inspired approach, moving quickly from understanding and sketching to testing and refinement.

THE FOCUS SHIFTED TOWARD:

cognitive calm

cognitive calm

clear activity intent

clear activity intent

participant-led collaboration

participant-led collaboration

facilitation without friction

facilitation without friction

From static guidelines to a collaborative workshop experience.

From static guidelines to a collaborative workshop experience.

WHAT I WORKED ON

My contribution focused on translating the guidelines into a practical, workshop-ready format.

WORKING IN SHORT, ITERATIVE CYCLES, I:

structured the content as a step-by-step Miro template

structured the content as a step-by-step Miro template

reduced text while preserving intent

reduced text while preserving intent

shaped activities so teams could act immediately

shaped activities so teams could act immediately

adapted content together with a content designer

adapted content together with a content designer

tested and refined the structure across multiple iterations

tested and refined the structure across multiple iterations

Final workshop template structure after multiple iterations.

Final workshop template structure after multiple iterations.

SHAPING THE WORKSHOP EXPERIENCE

KEY DESIGN DECISIONS:
Minimal activity text

Each step answers what we’re doing, why it matters, and the expected outcome.

Each step answers what we’re doing, why it matters, and the expected outcome.

Facilitator guidance off-stage

Support exists, but the workspace belongs to participants.

Support exists, but the workspace belongs to participants.

Structured sticky-note logic

Notes are tied to activities, not people — keeping outputs organised and reusable.

Through direct feedback shared in Altinn´s external channel in Slack

Through direct feedback shared in Altinn´s external channel in Slack

Visual hierarchy over decoration

Layout, spacing and colour guide attention and reduce hesitation.

Through direct feedback shared in Altinn´s external channel in Slack

Through direct feedback shared in Altinn´s external channel in Slack

One workshop activity showing clear structure and expected contributions.

One workshop activity showing clear structure and expected contributions.

Sticky-note structure designed to keep outputs organised and reusable.

Sticky-note structure designed to keep outputs organised and reusable.

OUTCOME & LEARNINGS

THE TEMPLATE ENABLES TEAMS TO:

collaborate digitally without extra explanation

collaborate digitally without extra explanation

understand purpose at a glance

understand purpose at a glance

work consistently across roles and locations

work consistently across roles and locations

apply plain language as a living practice

apply plain language as a living practice

KEY LEARNINGS:

strong methodology needs the right format to work in practice

strong methodology needs the right format to work in practice

reducing text can increase clarity and confidence

reducing text can increase clarity and confidence

sprint-based iteration helps surface usability issues early

sprint-based iteration helps surface usability issues early

Structured workshop output after a session using the template.

Structured workshop output after a session using the template.

WHAT I WOULD DO NEXT

validate the template with more teams across organisations

validate the template with more teams across organisations

refine facilitation guidance based on real sessions

refine facilitation guidance based on real sessions

explore how workshop outcomes could be exported into documentation workflows

explore how workshop outcomes could be exported into documentation workflows

REFLECTION

This project reinforced that public-sector UX is not about polish.

This project reinforced that public-sector UX is not about polish.

It is about reducing ambiguity and cognitive load so people can collaborate with confidence.

It is about reducing ambiguity and cognitive load so people can collaborate with confidence.

Plain language is not aesthetics — it is inclusion.

Plain language is not aesthetics — it is inclusion.

Tools should not shout.
They should quietly support people in doing the work.

Tools should not shout.
They should quietly support people in doing the work.