<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Mar 30, 2015 at 10:47 AM, Ionel Cristian Mărieș <span dir="ltr"><<a href="mailto:contact@ionelmc.ro" target="_blank">contact@ionelmc.ro</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><span class="">On Mon, Mar 30, 2015 at 6:39 PM, Xavier Fernandez <span dir="ltr"><<a href="mailto:xav.fernandez@gmail.com" target="_blank">xav.fernandez@gmail.com</a>></span> wrote:<br></span><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class=""><div dir="ltr">I think the point was not to say that documentation is useless (and there is some: <a href="http://flit.readthedocs.org/en/latest/" target="_blank">http://flit.readthedocs.org/en/latest/</a> ) but that the code/implementation is much simpler than the combination of distutils/setuptools/bdist_wheel.<br></div></span><div class="gmail_extra"><br><div class="gmail_quote"><span class=""><div><div>On Mon, Mar 30, 2015 at 5:26 PM, Ian Cordasco <span dir="ltr"><<a href="mailto:graffatcolmingov@gmail.com" target="_blank">graffatcolmingov@gmail.com</a>></span> wrote:<br></div></div></span><span class=""><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><br><div>So for new python programmers (or newbie users in general) reading the entire source of another package to understand it is a better experience? <br></div></div><br></div></div></div></div></blockquote></span></div></div></blockquote></div><div style="font-family:trebuchet ms,sans-serif">​<div style="font-family:trebuchet ms,sans-serif">​To put that in context, flit goes for less than 600 SLOC while distutils+setuptools+wheel amount to​ over 20000 SLOC. At that ratio arguments for distutils+setuptools+wheel documentation seem unreasonable.<br></div></div></div></div></blockquote><div><br></div><div>To be clear, no one should ever be advocating to "just read the source" as a form of documentation. This is why the Packaging guide exists (because no one should ever be expected to read the distutils, setuptools, or wheel source to use it).<br><br></div><div>Code is never as self-documenting as people like to believe. And since we're talking about new users (without defining what they're new to) reading the source should only be for educational purposes. cookiecutter will serve new users better than flit or anything else. cookiecutter will teach new users good package structure and take care of the (possibly hard parts) of a setup.py. Then, when the "new user" goes to publish it, there's tons of prior documentation on how to do it. If they run into problems using flit they have the skimpy documentation or the source.<br></div></div><br></div><div class="gmail_extra">Yeah, it's "easy" to read 600 SLOC for you, but what about for some "new user"? Are they new to python? Why do they have to care about reading the source if something else will "just work" as documented for their "simple" use case?<br></div></div>