astropy-tutorials icon indicating copy to clipboard operation
astropy-tutorials copied to clipboard

Don't use non or just quazi public API

Open bsipocz opened this issue 7 years ago • 1 comments

The tutorials should avoid using non user facing API, e.g. functionality from anything from astroquery.utils (maybe except TAP+ that already has it's own narrative docs, though also mostly destined to be used in other modules). These utilities are clearly listed under Developer Documentation here: https://astroquery.readthedocs.io/en/latest/index.html#developer-documentation

E.g. the FITS-cube tutorials uses TableList while it shouldn't.

bsipocz avatar Jun 11 '18 11:06 bsipocz

This note should be added to the dev docs. https://github.com/astropy-learn/dev-guide/

kelle avatar Jun 25 '25 18:06 kelle