----- Original Message -----
> From: "Walden Raines" <notifications@github.com>
> To: "theforeman/theforeman.org" <theforeman.org@noreply.github.com>
> Cc: "Joseph Magen" <jmagen@redhat.com>
> Sent: Tuesday, October 22, 2013 1:05:02 AM
> Subject: Re: [theforeman.org] beginning developer documentation for the v2 api standards (#106)
> 
> > @@ -0,0 +1,5 @@
> > +Single object responses are used for `show` actions.
> > +
> > +The object's root node name is the object name (ex. `domain`,
> > `environment`, etc) with no metadata since it's only one object.
> 
> I have trouble thinking of any metadata related to an object that wouldn't be
> in the object itself.
> 
> The above example is somewhat contrived, I don't think we'll ever want to
> pass back the http request status or the url the API consumer just
> requested.

Not contrived.  The example was taken from API hypermedia examples.  Even though we decided not to implement hypermedia at this time, I am in favor of being able to add it later with not breaking things.