/plushcap/analysis/temporal/temporal-docs-info-arch-2021

How we structured docs for user personas

What's this blog post about?

The author discusses their recent focus on refreshing Temporal's core concepts documentation area, which had not been updated in a couple of years and was criticized for being too industry-term heavy. They decided to start with Workflows and realized that the definition of a workflow is already well established across various resources. However, understanding Temporal's overall strategy and language-specific implementation details simultaneously is crucial. The author discovered that not all users are after the same information, as there are at least four unique user groups accessing the documentation. To meet these users' information needs, they decided to separate content based on user personas. They also redesigned Temporal's documentation landing page and created a more immersive experience for different user personas.

Company
Temporal

Date published
May 6, 2021

Author(s)
Cully Wakelin

Word count
1227

Hacker News points
None found.

Language
English


By Matt Makai. 2021-2024.