Documented API calls' return format.

This is in response to issue #108.

:ghost: :jack_o_lantern: :ghost: 
Change this to `the given project` or `'project'` or some other such phrase that disambiguates this; the reasoning is the same as in my comment on `list_free_nodes`.