On 3/21/2010 11:52 AM, John Posner wrote:
Thanks for joining and welcome to the team. And Don't Panic ;-)
Not panicking, exactly ... I've looked over the entire Hitchhiker's Guide. After a very nice Quick Start and pretty good initial sections in "Introduction to Packaging", things start to get more stream-of-consciousness-y and (to me) confusing. This seems to reflect the real world -- the "Current State of Packaging" diagram shows that this area of Python functionality is in a state of flux. Here's a bunch of questions -- not necessarily orthogonal to each other -- concerning the Guide. I'm posting to the entire SIG, to see if there's consensus out there. 1. What is the intended relationship between the Hitchhiker's Guide, a short document, and these much lengthier documents: For *distutils* -- Distributing Python Modules (http://docs.python.org/distutils/index.html) Installing Python Modules (http://docs.python.org/install/index.html) For *setuptools* -- Building and Distributing Packages with setuptools (http://peak.telecommunity.com/DevCenter/setuptools) For *distribute* -- Welcome to Distribute’s documentation! (http://packages.python.org/distribute/) 2. In the many areas where disutils/setuptools/distribute provide overlapping functionality, should the Hitchhiker's Guide promote *the one best way* to accomplish a task, or should it compare and contrast the various ways? 3. Should the Hitchhiker's Guide be an overview document, with cross-refs to large sections of the disutils/setuptools/distribute documents? Or should it be a detailed document, with (many more) cross-refs to detail sections of the disutils/setuptools/distribute documents? Thanks for helping me get up to speed ... -John