[tahoe-dev] easy_install failure on vista: Could not import twisted.

zooko zooko at zooko.com
Tue Sep 25 02:15:16 UTC 2007


On Sep 24, 2007, at 5:40 PM, Nathan wrote:

> IMO, the README would be better organized in an overview first
> fashion, describing the installation procedure first.

> The reason I say this is that is how I always traverse READMEs.  Do
> other people do it this way?

I'm not sure -- I suspect other people might read READMEs in a  
different order than that.  In particular, I user-tested this layout  
of the README a lot with Josh, and he seemed to be read it quite  
linearly.  If a thing was mentioned which hadn't already been  
explained, this threw him off.  I'm not sure if forward references  
(such as  "see the easy_install section below" that you suggest)  
would fix that.

How about if you cut and paste the README into the format that you  
describe so that we can compare them side by side?  Obviously, we  
would like for the README to work for both kinds of readers (plus any  
other kinds of readers there are)...

The specific bug that you hit (the manual dependencies) would have  
been fixed either by you being a linear reader or by the  
"easy_install" section having a backwards reference mentioning "you  
still have to do the non-easy_install-able dependencies -- see the  
dependencies section above".

Regards,

Zooko



More information about the tahoe-dev mailing list