[issue19179] doc bug: confusing table of values
Roundup Robot added the comment: New changeset 9aae58596349 by Georg Brandl in branch '2.7': Closes #19179: make table of XML vulnerabilities clearer by using everyday booleans and explaining the table beforehand. http://hg.python.org/cpython/rev/9aae58596349 -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19179 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue19179] doc bug: confusing table of values
Roundup Robot added the comment: New changeset 6b0ca3963ff1 by Georg Brandl in branch '3.3': Closes #19179: make table of XML vulnerabilities clearer by using everyday booleans and explaining the table beforehand. http://hg.python.org/cpython/rev/6b0ca3963ff1 -- nosy: +python-dev resolution: - fixed stage: - committed/rejected status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19179 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue19179] doc bug: confusing table of values
Terry J. Reedy added the comment: I agree that this could be improved. It took a few readings to convince myself that True == Vulnerable. (Assuming that this is correct ;-) the table needs a title like Vulernable or a lead in sentence: The following table indicates which modules are susceptible to which attacks. Since True and False are names of Python objects, I would also prefer Yes and No or X and blank or '-'. -- nosy: +eli.bendersky, terry.reedy ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19179 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue19179] doc bug: confusing table of values
New submission from Georg Brandl: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 [From Jason Scherer on d...@python.org] On this page: http://docs.python.org/2/library/xml.html The table of truth values is a bit confusing because it's not clear from the context what it's actually saying is true, or false. It might be better to replace the words true and false with vulnerable and protected or something like that. Otherwise, I can't tell if true means yes, this parser is vulnerable to this attack or if true means yes, this parser is protected from this attack -BEGIN PGP SIGNATURE- Version: GnuPG v2.0.21 (GNU/Linux) iEYEARECAAYFAlJRQ0IACgkQN9GcIYhpnLCziACeO3MzVKKcH8RLlU+w11hAy9Kh wo4AnRYvAXuCCLdlrED2SHJ0oexW1vj0 =dxxa -END PGP SIGNATURE- -- messages: 199066 nosy: georg.brandl priority: normal severity: normal status: open title: doc bug: confusing table of values ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19179 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue19179] doc bug: confusing table of values
Changes by Georg Brandl ge...@python.org: -- assignee: - docs@python components: +Documentation nosy: +christian.heimes, docs@python ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue19179 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com