search

meshy / pythonwheels

Adoption analysis of Python Wheels: https://pythonwheels.com/
BSD 2-Clause "Simplified" License
102 stars 26 forks source link

mention the Python Packaging User Guide (at least in a "how to help" section) #22

Closed qwcode closed 10 years ago

qwcode commented 10 years ago

The "Python Packaging User Guide" is aiming to be the authoritative guide for packaging and installation (including wheels).

https://python-packaging-user-guide.readthedocs.org/en/latest/

It's a PyPA (Python Packaging Authority) project, and has a commitment from Nick Coghlan (the python core dev who's been leading most of the latest PEP work) to be linked to from the python.org docs, and replace the outdated distutils tutorials.

The guide is still WIP and needs help, so it's still not ready for prime time linking, but minimally, it could be included in a "how to help" section. It's part of a larger effort (mostly by me right now), to improve all of the packaging and install docs that are relevant (i.e. pip, setuptools, virtualenv, wheel, and distutils). Users need more than tutorials ultimately to feel confident about the current tools. They need complete, accurate and inter-consistent documentation across all the projects.

meshy commented 10 years ago

Thank you for contacting me. I've been quietly dreading the idea that I might have to make this site a one-stop-shop of all python packaging know-how so am delighted to have a canonical resource to reference. I can sympathise about the WIP, believe me! I'm planning extensive changes to this website, and hoped to be able to link to documentation. It's good to know exactly where I should be sending people. I'll surely get your site in there. Thanks again, I'll update this issue when I get the time to make the appropriate changes.

LilyFoote commented 10 years ago

Fixed in 785d00c, 65524be.