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 pitrou
Recipients brett.cannon, eli.bendersky, eric.araujo, ezio.melotti, ncoghlan, petri.lehtinen, pitrou, terry.reedy
Date 2011-11-23.23:51:25
SpamBayes Score 2.503191e-10
Marked as misclassified No
Message-id <1322091978.3284.8.camel@localhost.localdomain>
In-reply-to <1322089868.98.0.515629705388.issue13455@psf.upfronthosting.co.za>
Content
> This is true, however different people can figure out a different
> amount of things just by using and experiment with something.  While
> most of the tasks should be obvious, some are a bit more advanced, and
> even the "obvious" once might not be obvious for everyone.  So IMHO
> writing down a few sentences doesn't hurt.

Well, it does hurt, because the more sentences you write, the more the
devguide becomes bloated and difficult to follow (especially for
non-native English speakers who might not read English very fast). The
devguide is *already* too big.

The devguide was supposed to be something that you read quickly and
easily, not an exhaustive reference of how development works. Or at
least there should be a clear separation between the two (the guide
part, and the reference part). The guide part being the most important,
while the reference is really optional.

And, really, if you want people to feel more comfortable with the
tracker, it would be more productive to improve the tracker itself. No
amount of documentation will make a UI usable.

> Also the lines between developer, contributor, and user that reports
> an issue are not so well defined, so it might be ok to add information
> that are not aimed just to core-developers in the devguide.

The devguide is *not* primarily for core developers. It's for new
contributors who want to get set up, so that they don't give up in the
absence of clear indications. Being useful for core developers is a nice
extra, but it was not the original intent.
History
Date User Action Args
2011-11-23 23:51:26pitrousetrecipients: + pitrou, brett.cannon, terry.reedy, ncoghlan, ezio.melotti, eric.araujo, eli.bendersky, petri.lehtinen
2011-11-23 23:51:25pitroulinkissue13455 messages
2011-11-23 23:51:25pitroucreate