I think the point was not to say that documentation is useless (and there is some: http://flit.readthedocs.org/en/latest/ ) but that the code/implementation is much simpler than the combination of distutils/setuptools/bdist_wheel.
On Mon, Mar 30, 2015 at 5:26 PM, Ian Cordasco <[email protected]> wrote: > > > On Mon, Mar 30, 2015 at 10:23 AM, Ionel Cristian Mărieș < > [email protected]> wrote: > >> >> On Mon, Mar 30, 2015 at 6:05 PM, Ian Cordasco <[email protected] >> > wrote: >> >>> 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. >> >> >> 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 packaging.python.org >> 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. >> > > So for new python programmers (or newbie users in general) reading the > entire source of another package to understand it is a better experience? > > > _______________________________________________ > Distutils-SIG maillist - [email protected] > https://mail.python.org/mailman/listinfo/distutils-sig > >
_______________________________________________ Distutils-SIG maillist - [email protected] https://mail.python.org/mailman/listinfo/distutils-sig
