Documentation that powers API strategy
summary
NPR rebuilds its developer center to expose the NPR One personalized listening experience via APIs that include authentication and playback/ratings signals, shifting docs from endpoint lists to task‑oriented docs that show how to authenticate, stream, and surface recommendations. Team runs interviews, defines personas, prioritizes common tasks, and rapid‑prototypes checklists and shallow navigation. Result is a redesigned docs site with measurable positive feedback and faster QA cycles despite limited resources.
AI-written summary · about
chapters (8)
- 0:00Introduction and mission
- 1:51Outcomes and experiences
- 3:35Products and services
- 5:44API strategy and goals
- 8:11Task-oriented documentation
- 10:44Redesign takeaways
- 12:28Developer relationships
- 13:56Checklist and summary
related talks
27mBoost Your API with Effective Documentation Strategies
25mDo you know who's reading your Docs?
20mRevamping API Docs: Boosting Developer Experience
19mAPIs in the media industry: models and trends for 2019
35mDocumenting APIs: new era, same craft
23mThe content devportal: Who writes the Docs?
19mStreamlining API Documentation: Proven DocOps Strategies
21mIntroducing The API Lifecycle