document our JSON/RESTful stuff!