[Numpy-discussion] Numpy deprecation schedule

[Nathaniel Smith]

On Wed, Mar 6, 2013 at 9:24 PM, Ralf Gommers <ralf.gommers at gmail.com> wrote:
> On Wed, Mar 6, 2013 at 9:38 PM, Nathaniel Smith <njs at pobox.com> wrote:
>>
>> On Wed, Mar 6, 2013 at 8:21 PM, Frédéric Bastien <nouiz at nouiz.org> wrote:
>> > That sound good. To be sure, the "now" mean the first release that
>> > include the deprecation, in that case NumPy 1.7?
>>
>> Yes.
>
>
> +1
>
> $ git add HOWTO_DEPRECATE.rst.txt  ?

+1

I'm vaguely intimidated by the doc structure, so I'm not sure where
this would go, but... aside from a formal description of how one does
a deprecation and the difference between DeprecationWarning and
FutureWarning, etc., we might even want to just add a whole page in
the manual that just lists the current status of all ongoing
deprecations, the releases where each change was made, the date for
the next change, etc., and use that as our canonical reference that we
check before each release? Since this is information that end-users
want to be able to see? ("I got this weird warning... what is it
trying to tell me? Which release started issuing it? What's my
deadline for fixing this?") And because this whole cycle of filing
multiple bugs and then shunting them off to the next release is pretty
awkward.

-n