<p dir="ltr"><br>
On 17 Jul 2014 05:28, "Richard Jones" <<a href="mailto:richard@python.org">richard@python.org</a>> wrote:<br>
><br>
> Thanks for the feedback, Josh.<br>
><br>
> The Python 3 version of the distutils documentation is far improved on this topic, I believe (though please, file a bug / change if you can improve it :)<br>
><br>
>    <a href="https://docs.python.org/3/distutils/sourcedist.html#manifest">https://docs.python.org/3/distutils/sourcedist.html#manifest</a><br>
><br>
> The setuptools documentation is part of the repository at <a href="https://bitbucket.org/pypa/setuptools/src">https://bitbucket.org/pypa/setuptools/src</a> in the docs directory, so you could file a bug against that project, or even submit a pull request to it if you're comfortable with that.<br>

><br>
> I believe it would be sensible to redirect from the distribute documentation to setuptools... what does distutils-sig think? I also noticed that the setuptools project front page (aka the README) still promotes easy_install - should that be updated?</p>

<p dir="ltr">I believe Marcus Smith is trying to coordinate efforts to bring the docs of the various PyPA projects up to date and providing a consistent message. Another part of that is getting the setuptools docs to a point where they stand alone, without depending on folks also going to read parts of the distutils docs.</p>

<p dir="ltr">It's all tricky to prioritise though - "providing a better experience for new users" tends to be a much weaker motivation for volunteer effort than "make the tooling better for me personally".</p>

<p dir="ltr">Cheers,<br>
Nick.</p>
<p dir="ltr">><br>
><br>
>      Richard<br>
><br>
><br>
> On 16 July 2014 22:47, Joshua Richardson <<a href="mailto:jricjr3@gmail.com">jricjr3@gmail.com</a>> wrote:<br>
>><br>
>> > And don't forget to include MANIFEST.in in MANIFEST.in.<br>
>> > <br>
>> > On 7/16/2014 8:00 AM, Vladimir Diaz wrote:<br>
>> > > Have you tried adding the line "include README.md" to MANIFEST.in?  That<br>
>> > > should do the trick.<br>
>><br>
>> It did do the trick!  Thanks so much!<br>
>><br>
>> Where should I submit a suggestion for improved documentation?<br>
>><br>
>> There was no documentation about the MANIFEST.in file format at <a href="http://guide.python-distribute.org/creation.html">http://guide.python-distribute.org/creation.html</a> or at <a href="https://pythonhosted.org/setuptools/setuptools.html#including-data-files">https://pythonhosted.org/setuptools/setuptools.html#including-data-files</a> .<br>

>><br>
>> Reading the documentation at <a href="https://docs.python.org/2/distutils/sourcedist.html#manifest">https://docs.python.org/2/distutils/sourcedist.html#manifest</a> , I got the impression that I should list the raw file names (or patterns) without the include directive.<br>

>><br>
>> Thanks, --josh<br>
>><br>
>><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>
><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>
></p>