[tahoe-dev] easy_install failure on vista: Could not import twisted.
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".
More information about the tahoe-dev