astropy/astropy — pull request #297 by astrofrog (2012-12-11 22:15:47+00:00)
Title: module stability document

Astropy consists of many modules, some in pre-alpha development and others stable for years now. The stability of each module, including its API within Astropy, should be clearly documented in a central, well-known place, so that people know what they can and can't depend on to be stable. If I'm writing software for a spacecraft project or instrument calibration pipeline that MUST be long-term stable, I might choose to use pyfits (now stable) but not NDData (not stable). A student working on a homework assignment might safely use NDData. I suggest both a web page and a help() function, e.g., help(astropy.stability).

--jh--