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