On Oct 10, 2015 9:55 AM, "Ionel Cristian Mărieș" <contact@ionelmc.ro> wrote:
On Sat, Oct 10, 2015 at 5:11 PM, Nick Coghlan <ncoghlan@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