[docs] [issue17006] Add advice on best practices for hashing secrets
report at bugs.python.org
Mon Jan 4 11:51:53 EST 2016
Ramchandra Apte added the comment:
It is good to add warnings; if they are ignored it is little worse than the
On 1 January 2016 at 08:54, Ezio Melotti <report at bugs.python.org> wrote:
> Ezio Melotti added the comment:
> > People are going to skip warning boxes if they occur too often.
> I'm not sure I agree. This would be true if they were abused for trivial
> things ("Warnings: using .pop() on a empty list will return an
> IndexError!"), but I don't think they are.
> I think warnings are ignored only by people that are already familiar with
> the module and its limitation/issues, and that know what they are doing.
> If the warning is not evident, people are going to miss it .
> If warnings are used correctly, people will spot them easily and read them
> (or ignore them if they already know what they are warning against).
> : I know I missed it in e.g. https://api.jquery.com/die/ -- the
> function is deprecated, but (currently) this is only written in the top
> right corner and in small in the category at the top -- two places that are
> easily overlooked. https://api.jquery.com/toggle-event/ on the other
> hand has a clearly visible yellow box at the top that immediately says that
> the method is deprecated.
> Python tracker <report at bugs.python.org>
Python tracker <report at bugs.python.org>
More information about the docs