Thanks for the great feedback, you&#x27;re completely right. I have switched up the language a bit.<p>Regarding hypermedia: I really, really want to work with someone to add first class support for it. I don&#x27;t think spec is a replacement but rather a compliment to hypermedia. The difference in benefit seeming to be static vs. dynamic client generation and I fully agree that dynamic ought to be the future. Right now static is easy to implement and still quite powerful despite requiring tradeoffs about things like needing to version releases of client libs rather than them being more durable in the dynamic scenario.