Revamping API Docs: Boosting Developer Experience
summary
Wise rebuilds docs at docs.wise.com by extracting API reference from prose guides into a single resource, breaking monolithic guides into product building blocks, and migrating Markdown into Markdoc powered pages on the crab app with Neptune components. A new reference tag injects live API snippets, a Postman collection button ships from pre-sales, and unique contributors grow from 23 to 80. The site supports dynamic components, stronger search, and a Developer Experience team now owning continued expansion.
AI-written summary · about
chapters (14)
- 0:00Introduction
- 1:06Wise platform and mission
- 3:11Wise Platform API
- 4:13API documentation importance
- 4:342018 API docs backstory
- 5:59Discovery and key issues
- 7:42Focus areas for improvement
- 8:46New information architecture
- 11:36Technical foundation
- 12:59Markdoc introduction
- 15:50Editing processes
- 16:53Success and feedback
- 18:17Next steps
- 18:58Feedback and closing
related talks
27mBoost Your API with Effective Documentation Strategies
43mUseful and Beautiful Developer Docs and How to Create Them
23mKeynote: The Human API: Building Your Project's Second Source of Truth
26mA sensible API Document Management guide
35mDev Experience in Technical Writing: 15 Tips to Boost Developer Satisfaction
35mDocumenting APIs: new era, same craft
39mDevelopers Documentation: your hidden strength
27mGetting developers hooked on your API