Documented API calls' return format.

This is in response to issue #108.

:ghost: :jack_o_lantern: :ghost: 
The current implementation doesn't list public networks, so this statement isn't actually accurate (it probably was before we added that feature). This wasn't correct before this patch, but let's take the opportunity to update it.