<div dir="ltr"><br><br><div class="gmail_quote"><div dir="ltr">On Tue, 17 Jul 2018 at 15:41 Nathaniel Smith <<a href="mailto:njs@pobox.com">njs@pobox.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Tue, Jul 17, 2018 at 9:44 AM, Jussi Judin <<a href="mailto:jjudin%2Bpython@iki.fi" target="_blank">jjudin+python@iki.fi</a>> wrote:<br>
> * Exceptions that are something else than the documented ones. These usually indicate an internal implementation issue. For example one would not expect an UnicodeDecodeError from netrc.netrc() function when the documentation[3] promises netrc.NetrcParseError and there is no way to pass properly sanitized file object to the netrc.netrc().<br>
<br>
My main advice would be, before mass-filing bugs make sure that you<br>
and the maintainers agree on what a bug is :-). For example, I can see<br>
the argument that invalid encodings in netrc should be reported as<br>
NetrcParseError, but there are also many APIs where it's normal to get<br>
something like a TypeError even if that's not a documented exception,<br>
and it's very annoying as a maintainer to suddenly get 20 bugs where<br>
you don't even agree that they're bugs and just have to wade through<br>
and close them all. Any assistance you can give with triaging and<br>
prioritizing the bugs is also super helpful, since volunteer<br>
maintainers aren't necessarily prepared for sudden influxes of issues.<br></blockquote><div><br></div><div>That was my initial reaction to that first bullet point as well. If the exception isn't at least explicitly raised then it shouldn't be considered a documentation problem, and even then I don't know if I would expect an explicit mentioning of ValueError if the docs say e.g. "only values within this range are expected" as that implicitly suggests ValueError will be used.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
In general this sounds like cool work, and help improving Python's<br>
quality is always welcome. Just be careful that it's actually helpful<br>
:-).<br></blockquote><div><br></div><div>It's definitely a balancing act. :) <br></div></div></div>