API proposal - first commit
added more api details, including answers to @cdeil's questions
a little more organization for the doc
added "base class" for astroquery api
added Delayed class
fixed code block formatting errors
moved api.rst
added example to api.rst
api update
added some notes, particularly related to issue #82