Re: [Pyobjc-dev] re: My second roadblock - lessons learned

[Jack J. <Jac...@cw...>]

First of all: thanks to Gary and Zachary for following the tutorial to 
the letter and reporting bugs like these!

Second, I think there's an important lesson in here: as the tutorial is 
going to be the very first thing newcomers will try it must be 
absolutely bug-free. In other words, before the next release we should 
do a code freeze and at that point someone should follow the tutorial 
(and follow it to the letter) to see that it still makes sense.

I think it might be a good idea to create a document 
"distribution-build.txt" or something like that in which we record the 
steps that need to be taken when creating a new distribution. This 
could include stuff like testing the tutorial, but also the 
incantations needed to create the installers, addresses of mailing 
lists and websites where we want to post announcements, etc. I have 
such a document for MacPython distributions (in 
Mac/Distributions/readme.txt), and I find that with every distribution 
I do there's one of the steps that cause the "oh! good that I wrote 
this down, otherwise I would have forgotten" sensation.
--
Jack Jansen, <Jac...@cw...>, http://www.cwi.nl/~jack
If I can't dance I don't want to be part of your revolution -- Emma 
Goldman