Start with the tasks, not the endpoints
summary
NPR One Developer Center redesign starts from interviews with partner developers to map real tasks (playing audio, posting ratings, auth flows), then reorganizes content into stepwise task pages while keeping Swagger-generated endpoint docs as an optional deep dive. Results: faster onboarding, shortened onboarding and app verification, fewer support tickets and steady newsletter engagement, plus clearer checklists and shallower navigation. Work on a hypermedia content service shows task-first docs help clients follow links across just two primary endpoints.
AI-written summary · about
chapters (12)
- 0:00Introduction
- 2:58Taskbased metaphor
- 5:06A shift in mindset
- 5:36In practice
- 6:44Design personas
- 15:44Feedback
- 17:48Benefits
- 18:49New Content Service
- 23:53Coffee Shop Metaphor
- 25:00Highlevel summary
- 25:59Sample workflow
- 26:28Wrap up
related talks
24mDocs for Developers: How to start when everything is hard
27mGetting developers hooked on your API
35mDev Experience in Technical Writing: 15 Tips to Boost Developer Satisfaction
28mWriting great "getting started" documentation
38mAPI Mastery: from the Design to Development
11mLeading without committing: Managing teams outside your tech stack
28mDesigning for Success: UX Principles for Internal Developer Platforms
20mUsing Design First to superpower your app development