Skip to content
Deidre CaseyLet's talk
← All case studies

Website services

Technical Documentation Website

A lightweight documentation site that let a fast-moving developer tools team publish on their own schedule, and reached 45,000 users.

Nordic Semiconductor

2022

Documentation design

Website design

Documentation

Developer experience

nRF Connect for VS Code extension pack documentation homepage

45K

unique users

2:53

minutes of average engagement

93%

of visits came directly to the site

The challenge

The nRF Connect for VS Code extension team released updates much faster than the main SDK, which shipped quarterly. If their docs lived in the main SDK repository, they would often be out of date. The team needed a documentation setup that could keep up with them.

My role: Documentation site designer. I chose the platform, designed the homepage, and set up a publishing workflow that matched the team's release cycle.

The approach

01

Choose a simple, friendly stack

I chose Material for MkDocs so writers and developers could work in plain Markdown, which is easier to learn than the RST and DITA formats used elsewhere. Automated GitHub workflows published every update to GitHub Pages.

02

Design a focused homepage

I wireframed and prototyped a custom homepage that highlighted key features and download links, and kept it minimal so the documentation stayed front and center.

03

Match the team's pace

Keeping the site separate from the main SDK docs meant the extension team could update their documentation whenever they shipped, without waiting for the quarterly cycle.

The documentation site

A clean homepage and documentation

The minimalist homepage highlighted the key features of the extension while clearly directing users to the matching documentation.

nRF Connect for VS Code home pagenRF Connect for VS Code features page highlighting one user interfaceSample Browser and project configuration guidance in nRF Connect for VS Code docs

Outcomes

The results

  1. 0145,000 unique users before the site joined Nordic's unified documentation platform in 2024
  2. 02Nearly three minutes of average engagement time, strong for a focused site of its size
  3. 0393% of visits came straight to the site, a sign that developers knew exactly where to find it

Next step

Not sure where to start? That's completely okay. It's exactly what the first call is for.

Let's talk about how you want your business to grow. We'll decide together what matters the most and where to get started.

Let's talk

A free 30-minute chat. No pressure, and no tech talk needed.