[issue13515] Consistent documentation practices for security concerns and considerations
Ezio Melotti
report at bugs.python.org
Thu Dec 1 09:10:22 CET 2011
Ezio Melotti <ezio.melotti at gmail.com> added the comment:
Grouping the common warnings in a "Security Considerations" section sounds OK, but the warnings should still be visible IMHO.
In my experience, people:
1) jump right to the doc for the function they are using;
2) read the example and try to figure out how it works;
3) if that fails, they read the text.
An inline text with a simple link might then pass unnoticed. OTOH littering the doc with red boxes is far too noticeable. Maybe we should use something in between (e.g. a "lighter" CSS for the warnings or a small warning icon).
----------
nosy: +ezio.melotti
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue13515>
_______________________________________
More information about the Python-bugs-list
mailing list