> Markdown version of [/events/world-congress-2026-europe-virtual-stage/sessions/1581-one-developer](https://www.wearedevelopers.com/events/world-congress-2026-europe-virtual-stage/sessions/1581-one-developer). Every page supports `.md` or `Accept: text/markdown`. Links point to the HTML versions so they work for humans too. Agent guide: [/agents.md](https://www.wearedevelopers.com/agents.md).

---

# One Developer Journey, Two Surfaces


- **Event:** World Congress 2026 Europe - Virtual Stage

## Recording

[Watch recording](https://www.wearedevelopers.com/videos/1986-one-developer-journey-two-surfaces)

## Description

Developers do not experience your docs and your product as separate things, but most companies still build and manage them that way.

A developer lands in the docs, jumps into the product, gets stuck, comes back to the docs, and keeps switching until the job gets done. This is not a neat funnel. It is one mental model across two surfaces. And when product copy, navigation, terminology, and workflows do not align, developers pay the cost.

In this practical session, I will share a simple framework for designing docs and product as one unified developer journey. I will cover how to write docs around jobs to be done instead of feature explanations, how to align navigation and language across product and docs, and how to support just-in-time learning so developers can learn while doing, not before doing.

I will also show how journey analytics can help teams identify where developers lose momentum between docs and product, and how small fixes such as better labels, better links, and better page openings can remove real friction.

This talk is based on hands-on collaboration across DevRel, product, design, and engineering at Scalekit. Attendees will leave with practical patterns they can apply immediately to make their docs and product feel like two windows into the same room.

## Speaker

### [Saif Ali Shaik](https://www.wearedevelopers.com/@saif-ali-shaik)

Founding developer advocate at Scalekit


## Related talks at this congress

- [Why Is Software Documentation Still Static – And Why Modern Browsers Deserve Better](https://www.wearedevelopers.com/events/world-congress-2026-europe-virtual-stage/sessions/1644-why-is-software) — André Dietrich, Jihad Hyadi
- [Backstage in Practice: Offloading Developer Operational Work Through Platform Self-Service](https://www.wearedevelopers.com/events/world-congress-2026-europe-virtual-stage/sessions/1496-backstage-in) — Um e Habiba
- [Thoughts on (Modern?) Software Development - Observations From a 21-Year Journey](https://www.wearedevelopers.com/events/world-congress-2026-europe-virtual-stage/sessions/1627-thoughts-on-modern) — Alex Thurow
- [The Async Revolution: Balancing Focus, Alignment, and Agility](https://www.wearedevelopers.com/events/world-congress-2026-europe-virtual-stage/sessions/1615-the-async-revolution) — Gabriel Casals