Phil and Matt, both in a loose definition of isolation, find time to talk to Arnaud Lauret (
https://twitter.com/apihandyman) and talk about API Design and Review. We discuss why you should spend time designing and reviewing your API and the process of reviewing API Designs before the code is written. We also ask Arnaud what he looks for while reviewing, the tools he uses to review API design docs and then Phil starts dreaming up what the ideal API Review tooling looks like.
We also talk about life in quarantine, as France completely shut down and how Phil made it back in time to England before the lock downs took place.
Sponsors:
Stoplight makes it possible for us to bring you this podcast while we nerd out about APIs. Check them out for their tooling around documentation with Studio, an app that makes API documentation an absolute joy to work with.
Links:
https://twitter.com/apihandyman - Arnaud's Twitter
https://bit.ly/designwebapis - The Design of Web APIs by Arnaud Lauret
https://en.wikipedia.org/wiki/The_Design_of_Everyday_Things - The Design of Everyday Things by Don Norman
http://apihandyman.io/ - Arnaud's blog
http://apistylebook.com/ - API Stylebook, a collection of API style guides