Talk: Doc-Driven Development: extending TDD to develop web APIs
Speakers directory
Speaker:
Richard Waller
Talk description
Title:
Doc-Driven Development: extending TDD to develop web APIs
Short synopsis:
API documentation is critical to fast development of web services. API docs form the contract describing how each service interacts with the outside world. If your server's behaviour doesn't match your API documentation, then you need to correct your server, your documentation, or both. The sooner you and your team know the better. I created and maintain an open source tool that makes sure your tests reflect your API docs. This ensures the integrity of your API docs and automates the writing and maintaining of API tests.
Max size: 500 chars
Long synopsis (optional):
This tool allows you to automatically test whether your server's behaviour and documentation match. It extends the Chai Assertion Library to support the OpenAPI standard for documenting REST APIs. You just specify your API in an OpenAPI.yaml file, then with one line of code connect your docs to your tests. Every test-run now verifies that your web server really satisfies your docs.
Max size: 5000 chars
Tags:
Speaker directory:
Listed in directory
Not listed
Speakers directory