Author ezio.melotti
Recipients docs@python, ezio.melotti, ncoghlan
Date 2011-12-01.12:12:49
SpamBayes Score 2.36003e-05
Marked as misclassified No
Message-id <1322741570.72.0.0455048089177.issue13515@psf.upfronthosting.co.za>
In-reply-to
Content
I think we are mixing a few different things here:
1) the content of the warning(s);
2) the position of the warning(s);
3) the style of the warning(s);

Duplicating the same content in each warning is bad, so a specific section that summarizes the problem is good.
Having at least a note with a link to the "Security consideration" section in each affected function is good too, because without them people won't notice it.
Having big red scary boxes is bad, because people are scared of big red things (especially scary ones), and our goal here is to warn, not to scare.

I think the problem with the subprocess doc is that there are many warnings and that they are big and red (and scary).  IMHO changing the style of the warning would already be a step forward the "clean look" advocated by Raymond.  Grouping redundant text and possibly rephrasing it a bit would do the rest.
History
Date User Action Args
2011-12-01 12:12:50ezio.melottisetrecipients: + ezio.melotti, ncoghlan, docs@python
2011-12-01 12:12:50ezio.melottisetmessageid: <1322741570.72.0.0455048089177.issue13515@psf.upfronthosting.co.za>
2011-12-01 12:12:50ezio.melottilinkissue13515 messages
2011-12-01 12:12:49ezio.melotticreate