This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author vstinner
Recipients mdk, ned.deily, pablogsal, rhettinger, vstinner
Date 2021-04-16.09:40:34
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1618566035.02.0.950007740451.issue42238@roundup.psfhosted.org>
In-reply-to
Content
Pablo: "I every single alpha release I had to fix actual documentation errors (no false positives)"

I don't get it. Do you mean that the Python release process is blocked by typos in the documentation? Why did you catch them in the release process, and not in the regular Python development workflow?

Can't we get the same errors in the regular workflow?

I understand that the release process requires no warning from "make suspicious", but as explained in other comments, this tool is not reliable. While it catchs some real bugs, the cost of false positives is too high.

Doc/tools/susp-ignored.csv contains 368 lines, IMO it's a sign that this tool either requires a serious reworking, or must be disabled/removed.

Doc/tools/extensions/suspicious.py is a CPython specific extension, it's not part of Sphinx. Maybe someone should open a feature request on Sphinx to get a similar feature without false positives (or at least less false positives).
History
Date User Action Args
2021-04-16 09:40:35vstinnersetrecipients: + vstinner, rhettinger, ned.deily, mdk, pablogsal
2021-04-16 09:40:35vstinnersetmessageid: <1618566035.02.0.950007740451.issue42238@roundup.psfhosted.org>
2021-04-16 09:40:35vstinnerlinkissue42238 messages
2021-04-16 09:40:34vstinnercreate