I love Atlassian's REST API Design Guidelines

link ->Atlassian REST API Design Guidelines version 1 - REST APIs:

If we go with creating a public API we should totally steal this as our coding standard. I really love their expand idea. I have been wondering how we should handle cross aggregate references. I think what they did makes total sense.