If you're interested in re-use in Swagger, see the guidelines here: https://github.com/swagger-api/swagger-spec/blob/master/guid...

Swagger added support for examples with version 2.0 of the format, see: https://github.com/swagger-api/swagger-spec/blob/master/vers...

Letting out my inner conspiracy theorist for a moment, a prism can be used to split light. For example, think of a pentaprism mirror in many DSLR cameras.

Did the NSA choose "PRISM" because they are splitting the signal upstream of providers, thus giving private companies plausible deniability?

Yes, but JSON is JavaScript Object Notation, not (PHP|Ruby|C#|Java|Other) Object Notation. Therefore, since JSON is a serialization of JavaScript, it recommends that you should adopt the JavaScript convention of camelCase.

Usergrid ( https://apigee.com/usergrid ) addresses at least some of what you're looking for. If you try it, let me know, as I'm part of that team that's working on it.

It's still a better word than 'HATEOAS' (Hypermedia As The Engine Of Application State), which has to be in the running for worst acronym ever.

It is limited to Twitter only so we could launch it faster and iterate quickly. There is lots more to come!

Maybe a sneak peek on the "lots more to come" ?!

:) That's what I thought. Well done.

The Apigee blog uses Disqus, so you should be able to comment: http://blog.apigee.com/detail/api_design_for_developers/

Always interested in feedback, either on giving better talks or on making better APIs / developer experiences.

strangely enough, this was your 51st backtype comment... and you had 51 people following you at the time...