[Twisted-Python] Simpler twistedmatrix.com doc indexes

[Simon]

Hi Brendon,
I would suggest you make the main doc page much simpler. I'd like to see
it focus on the core docs and perhaps provide some form of preferred or
recommended learning path. If the intention is to help people new to
Twisted I think we have to narrow the selection down so it don't become
too overwhelming. At least my learning experience with Twisted was to
take it a chunk at a time. Trying to grip the whole project is just too
much to start with.
I'm not saying your index is bad, just that it'd probably be good to add
some intro page.

/Simon

-----Original Message-----
From: twisted-python-bounces at twistedmatrix.com
[mailto:twisted-python-bounces at twistedmatrix.com] On Behalf Of Brendon
Hogger
Sent: den 17 maj 2005 09:01
To: Twisted general discussion
Subject: Re: [Twisted-Python] Simpler twistedmatrix.com doc indexes


> It looks good... but we don't actually really *have* a master doc 
> index any more (yes http://twistedmatrix.com/documents still exists, 
> but the docs there are 1.3). Do you suggest we restore it?

Yes. I think it's much easier to get an idea of what's available when
it's all collected together in one place. It seems fairly common to hear
people say that Twisted is lacking documentation because they just don't
stumble across it.

- Brendon

_______________________________________________
Twisted-Python mailing list
Twisted-Python at twistedmatrix.com
http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python