by laura / 1 June, 2017

The annual North-American Write The Docs conference this May featured 2 API documentation redo presentations:

Lyzi Diamond described Mapbox (formerly a part of Development Seed) documentation automagic in detail, Sarah Hersh talked about the journey that NPR One undertook towards a new task-based approach for their API's developer documentation.

In this post we aim to give you an account of these presentations, plus a little extra takeaway.

Lyzi Diamond: Testing: it's not just for code anymore

Lyzi Diamond from Mapbox showcased the use of docbox on their own documentation, through remark and retext. Lyzi showed why it works for them to test everything.

The story started in 2015, December, when Mapbox had a confusing TOC for their developer docs. They... Read more