On Oct 10, 2015 9:55 AM, "Ionel Cristian Mărieș" <cont...@ionelmc.ro> wrote: > > > On Sat, Oct 10, 2015 at 5:11 PM, Nick Coghlan <ncogh...@gmail.com> wrote: >> >> This unfortunately isn't a good idea, at least for folks aiming to >> publish their first project. While it's well-intentioned, the problem >> with it is that it can be *tremendously* demotivating for folks that >> aren't already familiar with all those additional niceties, as it hits >> newcomers over the head with how much they still have to learn. >> Testing in particular is problematic, as writing tests involves >> writing programs about programs. That means you need to already >> understand a fair bit about programs *and* about how programs fail, to >> appreciate why it may make sense to write a second program to make >> sure the first program is behaving as you expect. Folks that already >> have that knowledge aren't going to need the packaging guide to tell >> them how to do it, while folks that don't have that knowledge are >> going to be confused by a digression on testing and documentation when >> they're wanting to learn about packaging and distribution. > > > This begs the conception of yet another opinionated guide for X, Y and Z in Python. I believe we got plenty of those, and what encouraged their creation is exactly this sort of thinking. > > The problem is that none of them are really comprehensive, well maintained or authoritative enough (we wouldn't have this discussion if there was). They may have been "well-intentioned" but they only create confusion now ... > > What if there was something official-ish that takes the packaging guide further, for people that want more than just packaging? It seems that there is some demand.
references for such a CreativeWork * http://docs.python-guide.org/en/latest/scenarios/ci/ * https://en.wikipedia.org/wiki/Continuous_integration#Best_practices * http://docs.python-guide.org/en/latest/writing/documentation/ * https://docs.python.org/devguide/documenting.html#sections * http://docs.python-guide.org/en/latest/writing/tests/ * https://packaging.python.org/en/latest/glossary/ * /peps /projects * https://westurner.org/tools/#python-packages * more links above (in this thread) * dox (docker + tox), cookiecutter- * https://westurner.org/tools/#python * https://westurner.org/wiki/awesome-python-testing > > > > Thanks, > -- Ionel Cristian Mărieș, http://blog.ionelmc.ro > > _______________________________________________ > Distutils-SIG maillist - Distutils-SIG@python.org > https://mail.python.org/mailman/listinfo/distutils-sig >
_______________________________________________ Distutils-SIG maillist - Distutils-SIG@python.org https://mail.python.org/mailman/listinfo/distutils-sig
