Zen and the Art of REST API documentation - 'Document them and they will come' (as Kevin Costner might have said)
Please log in to watch this conference skillscast.
Struggling to document your APIs? Still using a wiki page to do it? Come to this talk and learn the secrets of documenting REST APIs! One of the secrets to a successful Microservices application is the quality of its APIs - so using a decent tool to help develop them is essential; without the right tool, producing APIs can become as tedious as reading through a dump file. This talk introduces and demonstrates a selection of opensource tools intended to help with not just documenting APIs but designing and testing them as well. Tools covered will include: Swagger, RAML, Spring RestDocs and Apiary.
YOU MAY ALSO LIKE:
- Locally Developing Microservices using the Environment Leasing Pattern with Stephen Judd! (SkillsCast recorded in October 2017)
- Strategic DDD & Sociotechnical Architecture with Kacper Gunia and Nick Tune (in London on 30th September - 1st October 2019)
- Fast Track to Chaos Engineering with Russ Miles (in London on 6th - 8th November 2019)
- ProgNET London 2019 (in London on 11th - 13th September 2019)
- CloudNative London 2019 (in London on 25th - 27th September 2019)
- Keynote by Burr Sutter on Kubernetes Native Java with Quarkus (in London on 16th January 2020)
- Acceptance Testing in Microservices (SkillsCast recorded in July 2019)
- On Stage Hacking: Build 12-Factor Microservices in an Hour (SkillsCast recorded in July 2019)
Thanks to our sponsors
Zen and the Art of REST API documentation - 'Document them and they will come' (as Kevin Costner might have said)
Stephen Judd
Stephen Judd is a Principal Consultant specialising in Systems Architecture, with a focus on Open source products and frameworks. He has considerable experience in leading and mentoring software development teams delivering pragmatic and innovative front and back-end applications.
Please log in to watch this conference skillscast.
Struggling to document your APIs? Still using a wiki page to do it? Come to this talk and learn the secrets of documenting REST APIs! One of the secrets to a successful Microservices application is the quality of its APIs - so using a decent tool to help develop them is essential; without the right tool, producing APIs can become as tedious as reading through a dump file. This talk introduces and demonstrates a selection of opensource tools intended to help with not just documenting APIs but designing and testing them as well. Tools covered will include: Swagger, RAML, Spring RestDocs and Apiary.
YOU MAY ALSO LIKE:
- Locally Developing Microservices using the Environment Leasing Pattern with Stephen Judd! (SkillsCast recorded in October 2017)
- Strategic DDD & Sociotechnical Architecture with Kacper Gunia and Nick Tune (in London on 30th September - 1st October 2019)
- Fast Track to Chaos Engineering with Russ Miles (in London on 6th - 8th November 2019)
- ProgNET London 2019 (in London on 11th - 13th September 2019)
- CloudNative London 2019 (in London on 25th - 27th September 2019)
- Keynote by Burr Sutter on Kubernetes Native Java with Quarkus (in London on 16th January 2020)
- Acceptance Testing in Microservices (SkillsCast recorded in July 2019)
- On Stage Hacking: Build 12-Factor Microservices in an Hour (SkillsCast recorded in July 2019)
Thanks to our sponsors
Zen and the Art of REST API documentation - 'Document them and they will come' (as Kevin Costner might have said)
Stephen Judd
Stephen Judd is a Principal Consultant specialising in Systems Architecture, with a focus on Open source products and frameworks. He has considerable experience in leading and mentoring software development teams delivering pragmatic and innovative front and back-end applications.