Successfully reported this slideshow.
Your SlideShare is downloading. ×

Apiconf - Doc Driven Development

Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Loading in …3
×

Check these out next

1 of 8 Ad
Advertisement

More Related Content

Slideshows for you (20)

Similar to Apiconf - Doc Driven Development (20)

Advertisement

More from Corley S.r.l. (20)

Recently uploaded (20)

Advertisement

Apiconf - Doc Driven Development

  1. 1. API Documentation Gabriele Mittica - @gabrielemittica
  2. 2. APICONF 2017- Gabriele Mittica Documentation can be boring!
  3. 3. APICONF 2017- Gabriele Mittica Design Define Doc Code Test Manage
  4. 4. The goal ▪ Set interfaces and nomenclatures ▪ Define input and output ▪ Define error codes and responses APICONF 2017 – Gabriele Mittica
  5. 5. The problem ▪ It’s a long job ▪ List endpoints is not enough ▪ I need to put business logic in to documentation APICONF 2017 – Gabriele Mittica
  6. 6. How to ▪ Doc-driven and test-driven development ▪ Explain business logic ▪ Declare versioning and growth of APIs ▪ Don’t create doc by layout but by logic APICONF 2017 – Gabriele Mittica
  7. 7. APICONF 2017- Gabriele Mittica Doc Design Define CodeTest Manage
  8. 8. The doc is the only contract with the customer Thanks for Listening APICONF 2017- Gabriele Mittica

×