[Numpy-discussion] Numpy deprecation schedule

Nathaniel Smith njs@pobox....
Wed Mar 6 15:40:47 CST 2013


On Wed, Mar 6, 2013 at 9:24 PM, Ralf Gommers <ralf.gommers@gmail.com> wrote:
> On Wed, Mar 6, 2013 at 9:38 PM, Nathaniel Smith <njs@pobox.com> wrote:
>>
>> On Wed, Mar 6, 2013 at 8:21 PM, Frédéric Bastien <nouiz@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


More information about the NumPy-Discussion mailing list