<p dir="ltr"><br>
On Oct 10, 2015 9:55 AM, "Ionel Cristian Mărieș" <<a href="mailto:contact@ionelmc.ro">contact@ionelmc.ro</a>> wrote:<br>
><br>
><br>
> On Sat, Oct 10, 2015 at 5:11 PM, Nick Coghlan <<a href="mailto:ncoghlan@gmail.com">ncoghlan@gmail.com</a>> wrote:<br>
>><br>
>> This unfortunately isn't a good idea, at least for folks aiming to<br>
>> publish their first project. While it's well-intentioned, the problem<br>
>> with it is that it can be *tremendously* demotivating for folks that<br>
>> aren't already familiar with all those additional niceties, as it hits<br>
>> newcomers over the head with how much they still have to learn.<br>
>> Testing in particular is problematic, as writing tests involves<br>
>> writing programs about programs. That means you need to already<br>
>> understand a fair bit about programs *and* about how programs fail, to<br>
>> appreciate why it may make sense to write a second program to make<br>
>> sure the first program is behaving as you expect. Folks that already<br>
>> have that knowledge aren't going to need the packaging guide to tell<br>
>> them how to do it, while folks that don't have that knowledge are<br>
>> going to be confused by a digression on testing and documentation when<br>
>> they're wanting to learn about packaging and distribution.<br>
><br>
><br>
> ​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.<br>
><br>
> 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 ...<br>
><br>
> 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.</p>
<p dir="ltr">references for such a CreativeWork</p>
<p dir="ltr">* <a href="http://docs.python-guide.org/en/latest/scenarios/ci/">http://docs.python-guide.org/en/latest/scenarios/ci/</a></p>
<p dir="ltr">  * <a href="https://en.wikipedia.org/wiki/Continuous_integration#Best_practices">https://en.wikipedia.org/wiki/Continuous_integration#Best_practices</a></p>
<p dir="ltr">* <a href="http://docs.python-guide.org/en/latest/writing/documentation/">http://docs.python-guide.org/en/latest/writing/documentation/</a><br>
  <br>
   * <a href="https://docs.python.org/devguide/documenting.html#sections">https://docs.python.org/devguide/documenting.html#sections</a></p>
<p dir="ltr">* <a href="http://docs.python-guide.org/en/latest/writing/tests/">http://docs.python-guide.org/en/latest/writing/tests/</a></p>
<p dir="ltr">* <a href="https://packaging.python.org/en/latest/glossary/">https://packaging.python.org/en/latest/glossary/</a></p>
<p dir="ltr">  * /peps /projects<br>
  * <a href="https://westurner.org/tools/#python-packages">https://westurner.org/tools/#python-packages</a></p>
<p dir="ltr">* more links above (in this thread)</p>
<p dir="ltr">   * dox (docker + tox), cookiecutter-</p>
<p dir="ltr">* <a href="https://westurner.org/tools/#python">https://westurner.org/tools/#python</a></p>
<p dir="ltr">  * <a href="https://westurner.org/wiki/awesome-python-testing">https://westurner.org/wiki/awesome-python-testing</a><br>
 </p>
<p dir="ltr">><br>
><br>
><br>
> Thanks,<br>
> -- Ionel Cristian Mărieș, <a href="http://blog.ionelmc.ro">http://blog.ionelmc.ro</a><br>
><br>
> _______________________________________________<br>
> Distutils-SIG maillist  -  <a href="mailto:Distutils-SIG@python.org">Distutils-SIG@python.org</a><br>
> <a href="https://mail.python.org/mailman/listinfo/distutils-sig">https://mail.python.org/mailman/listinfo/distutils-sig</a><br>
><br>
</p>