transformed doc strings to use Astropy/Sphinx markup

This addresses #20 (Convert to astropy docstring standard)