<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Mar 30, 2015 at 6:05 PM, Ian Cordasco <span dir="ltr"><<a href="mailto:graffatcolmingov@gmail.com" target="_blank">graffatcolmingov@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">In other words, no one should read the docs because that's a waste of time? Because a lot of time has been poured into the packaging docs and if they're not sufficient, then instead of improving them, people should write undocumented tools that force people to read the source? I'm not sure how that's better than what we already have.</blockquote></div><br><div class="gmail_default" style="font-family:trebuchet ms,sans-serif">​A waste of time? No. But it sure is poor investment of time for newbie users. It's a futile struggle to document (or read about) all the features of distutils and setuptools, not because it can't be documented, but because there's too much ground to cover and PyPA's <a href="http://packaging.python.org">packaging.python.org</a> approach is to ​just give an overview of what's available and avoid giving any real best practice recommendations as much as possible. There may be good reasons for that but that's not a sensible approach to giving users a "pitfall free" learning path.<br></div><br><br clear="all"><div><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div><span style="font-family:trebuchet ms,sans-serif"><span style="color:rgb(51,51,51)"><br><font><span style="color:rgb(51,51,51)">Thanks,</span><br><span style="color:rgb(153,153,153)">-- Ionel</span></font></span><font><font style="color:rgb(153,153,153)"> Cristian Mărieș, <a href="http://blog.ionelmc.ro" target="_blank">http://blog.ionelmc.ro</a><br></font></font></span></div></div></div></div></div></div></div>
</div></div>