API Evolution (Page 33)

Writings about API Design, OpenAPI, HTTP and related topics.

Naming things is hard

Much of my career has been spent with me as the most senior developer on my team.  It has its pros and cons, I have learned how to figure stuff out on my own, but I have had to re-make many mistakes that I could have avoided.

Read more...

Don’t sacrifice suppleness to the DRY gods

Consider your application has feature A and feature B, and in order to implement each of these features you need to invoke functions X, Y, Z:

Read more...

Hypermedia Client Maturity Model

There have been a number of attempts to define a maturity model for building RESTful services.  The idea of the maturity model is that is gives an indication how closely the service complies with the constraints of REST and hopefully demonstrates the trade offs to be expected when choosing to not follow a particular constraint.

Read more...