<div dir="auto"><div><div class="gmail_quote"><div dir="ltr">On Sat, Dec 1, 2018, 06:56 Steve Holden <<a href="mailto:steve@holdenweb.com">steve@holdenweb.com</a> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_default" style="font-size:small">We* should probably do more collectively to point people at production-quality third-party modules, as I believe we currently do with pipenv which, while not a part of the standard library, is still recommended in the documentation as the preferred method of dependency management.</div></div></blockquote></div></div><div dir="auto"><br></div><div dir="auto">Small correction: the only "official" recommendation for pipenv is that <a href="http://packaging.python.org">packaging.python.org</a> (which is maintained by pypa, not python-dev) contains several tutorials, and one of them discusses how to use pipenv. For a while Kenneth used this as justification for telling everyone pipenv was "the officially recommended install tool", and this created a lot of ill will, so the pipenv team has been working on rolling that back.</div><div dir="auto"><br></div><div dir="auto">A better precedent is requests. There was a long discussion a few years ago about whether requests should move to the stdlib, and the outcome was that it didn't, but the urllib docs got a note added recommending the use of requests, which you can see here:</div><div dir="auto"><br></div><div dir="auto"><a href="https://docs.python.org/3/library/urllib.request.html#module-urllib.request">https://docs.python.org/3/library/urllib.request.html#module-urllib.request</a><br></div><div dir="auto"><br></div><div dir="auto">Personally I would have phrased the note more strongly, but my perspective is skewed by having tried to understand the internals. I'm glad urllib has helped a lot of people solve their problems, but there's also a lot of ways that it's flat out broken.</div><div dir="auto"><br></div><div dir="auto">Anyway, I agree that there are probably other places where the docs could use this technique.</div><div dir="auto"><br></div><div dir="auto">-n</div></div>