notes-computer-programming-development-api
notes on how to make good APIs:
http://apiux.com/2013/04/09/rest-metadata-formats/