PurPassionDigital / Everywhere
The landscapeTechnical Writing & Information DesignDeveloper Experience & API Documentation Engineer
Technical Writing & Information Design · Digital / Everywhere

Developer Experience & API Documentation Engineer

Unexpected
Explanation · Confused UnderstoodThe pull to make things make sense
Pace
  • A steady rhythm with room to breathe
  • A hard push you keep up for a long stretch
What your week looks likeQuiet stretches, then deadline storms
How much you move around at workScreen and chair, almost all day
Whether you can work from anywhereWork from anywhere with a signal or internet connection
How quickly you receive feedback on your workGive it a few days
What you're actually working withNumbers, measurements, records — things you read on a screen / Concepts, theories, designs, stories — things you think up

Core
  • Creating the record that allows others to understand later.
  • Applying systematic problem-solving to make things work reliably.
  • Making something complex graspable.
  • Verifying whether something is true or works as claimed.
Also present
  • Making rough versions fast to test whether an idea works.
  • Reducing complexity without losing truth.
  • Creating the framework that holds things together.

This is the branch of the field closest to engineering, and the distinct contribution is what separates it from a technical author: a developer experience writer usually has to be able to write and run code themselves, because the audience is other developers who will immediately notice if a code sample does not actually work. The job is not describing an API from the outside — it is using the API the way a real integrating developer would, documenting exactly what that experience is like, and fixing the parts of the experience itself (error messages, onboarding flow, sample code) that make the API hard to use, which is why Resolution sits as a genuine secondary pull here in a way it does not for a technical author writing a user manual.

The daily texture blends writing with something closer to junior software engineering: standing up a test integration, working through the API's happy path and its failure modes, and then writing the reference material and tutorials that let the next developer skip the struggle the writer just went through themselves.

🦊
There's a guide here if you want one

Kitsune can talk through anything on this page — whether it might suit you, what to do next, questions this page doesn't answer. Everything here is yours to read either way.

The boundary with software engineering is genuinely blurry, and that is a feature, not a confusion to resolve — the strongest developer experience writers are often engineers who found they preferred making an API usable to building the next one, and the role is one of the more common landing places for someone who studied computer science but discovered a stronger pull toward Explanation than toward Resolution or Creation as their primary satisfaction. AI tooling can now draft a plausible-looking first pass of API reference documentation directly from code comments and type signatures, which has genuinely raised the bar for what counts as valuable human output in this specific corner of the field — the writer's real value has shifted toward judging what the AI draft got subtly wrong, filling in the parts that require actually using the API as an outsider would, and building the surrounding tutorials and conceptual guides an LLM cannot infer from source code alone.

There is no fixed credential. The most common route is a computer science or software engineering background that pivots toward writing, or a technical writing background that invests seriously in learning to code well enough to work inside a real codebase; either direction is viable, and hiring managers generally care more about a portfolio of clear, working API documentation than about which direction someone arrived from. The "Write the Docs" community and its conferences function as the field's most active informal network for this specific specialism, with sessions consistently focused on developer documentation and docs-as-code practice [official, Write the Docs 2026].

Developer Experience & API Documentation Engineer · Technical Writing & Information Design · PurPassion