Author ezio.melotti
Recipients brett.cannon, ezio.melotti, r.david.murray, sjt, willingc
Date 2015-12-30.05:46:06
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1451454367.28.0.841740480254.issue24682@psf.upfronthosting.co.za>
In-reply-to
Content
FWIW when I added the quickstart (#13228), its main target wasn't newbies, but devs that already have experience with other open source projects and want to contribute to CPython.
These people just need to know where is the repo and the bug tracker, how to build Python, and how to run the tests.

OTOH, the quickstart is also useful to newbies as it provides a concise list of steps and additional links that cover them in greater detail.

So there are at least two targets here:
* experienced devs: they know what they want and they are looking for specific steps that will bring them there.  They also tend to skip wordy sections (so no important info should be hidden in a wall of text).
* newbies: they might not know what they want and/or what to do and need more guidance in a more verbose fashion.

I would leave the quickstart as is, and possibly add a separate introduction as R. David suggested.
History
Date User Action Args
2015-12-30 05:46:07ezio.melottisetrecipients: + ezio.melotti, brett.cannon, r.david.murray, sjt, willingc
2015-12-30 05:46:07ezio.melottisetmessageid: <1451454367.28.0.841740480254.issue24682@psf.upfronthosting.co.za>
2015-12-30 05:46:07ezio.melottilinkissue24682 messages
2015-12-30 05:46:06ezio.melotticreate