This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author chris.jerdonek
Recipients chris.jerdonek, eric.araujo, ezio.melotti, mikehoy, ncoghlan, pitrou, terry.reedy, tshepang
Date 2012-10-11.08:15:23
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1349943323.99.0.0634102826667.issue13440@psf.upfronthosting.co.za>
In-reply-to
Content
> I'll say it again, the devguide should be short enough to be practical for someone learning to contribute.

Better organization could help here.  I could see the devguide being a combination of (1) a brief document meant to be read cover to cover that captures the minimum one needs to know (as well as describing what else is available in the guide), and (2) more detailed info that someone could read on an as-needed basis or that a core developer could link to if assisting someone on a certain point (like the point covered by this issue).

Currently, the devguide is harder to soak in because there is no boundary between (1) and (2).  A recent example is that I didn't know about the custom repo option until Antoine mentioned it in a comment -- even after having looked at many of the sections.  On the plus side, he was able to link to it with the current organization.
History
Date User Action Args
2012-10-11 08:15:24chris.jerdoneksetrecipients: + chris.jerdonek, terry.reedy, ncoghlan, pitrou, ezio.melotti, eric.araujo, tshepang, mikehoy
2012-10-11 08:15:23chris.jerdoneksetmessageid: <1349943323.99.0.0634102826667.issue13440@psf.upfronthosting.co.za>
2012-10-11 08:15:23chris.jerdoneklinkissue13440 messages
2012-10-11 08:15:23chris.jerdonekcreate