Improving Experience for
PyKX Documentation
Improving Experience for PyKX Documentation
Improving Experience
PyKX Documentation
Simplifying technical documentation navigation so developers can find information faster, get started with confidence, and move through content more easily.
Challenge
The PyKX documentation grew over time and became hard to navigate. Developers often struggled to find what they needed, know where to start, or move between high-level ideas and real examples — especially challenging for new users.
Design Goal
Create a clear structure that helps developers find information faster, get started with confidence, and move through the content more easily.
My Role
I supported the Senior Product Designer throughout the project. My responsibilities included creating testing assets such as wireframes and navigation structures, supporting card sorting exercises and navigation testing, and synthesizing findings from interviews and usability feedback.
User Research
Prototyping
Wireframing
Card Sorting
A/B Testing
Data Synthesis
The Challenge
The PyKX documentation grew over time and became hard to navigate. Developers often struggled to find what they needed, know where to start, or move between high-level ideas and real examples — especially challenging for new users.
Design Goal
Create a clear structure that helps developers find information faster, get started with confidence, and move through the content more easily.
My Role
I supported the Senior Product Designer throughout the project. My responsibilities included creating testing assets such as wireframes and navigation structures, supporting card sorting exercises and navigation testing, and synthesizing findings from interviews and usability feedback.
Card sorting
Navigation Testing
Prototyping
Wireframing
Usability Research
A/B Testing
Data Synthesis
Results
Impact and Outcomes
Impact and Outcomes
Research
Understanding the Users
Understanding the Users
These insights directly shaped the new site structure and menu design.
What We Learned
What We Learned
From research and mapping, we surfaced three core usability issues:
Design & Test
Prototypes & Validation
Prototypes & Validation
Propotypes
Propotypes
Working closely with the Senior Designer, I contributed to creating testing wireframes and prototypes for the new documentation layout. My focus areas included:
Prototyping alternative navigation models
Documenting page relationships and navigation flows
Testing and iterating on sidebar layouts and in-page links
Before
An overcrowded, unstructured left navigation forced users to scan long lists and guess where information lived.
After
Grouped and renamed sections to improve clarity, with content now nested under more intuitive categories
A/B Testing
To measure the impact of the new navigation, we ran an A/B test in Maze with 60 participants, comparing the redesigned layout (v3.0) with the original navigation (v2.5). Participants were randomly assigned to reduce bias and completed 10 tasks across both versions.
🔥 Heatmap Insights
To better understand user behavior, we reviewed click heatmaps from Maze for both the original and redesigned navigation.
Before
Clicks were scattered, showing confusion about where to go.
After
Clicks followed a clear path, showing more confident navigation.
Reflection
What I Learned
What I Learned
This project deepened my understanding of information architecture and how research-driven decisions can directly improve usability.
