On 02/26/2003 02:24:47 AM Clark wrote: >I think it is entirely fair critique. And I don't think it is >disparaging... no software project is ever perfect. Webware and >Twisted are among the most innovative and best run projects >out there... despite their documentation. ;) > >The context of people on _this_ list (and probably 90% of the visitors >to the twistedmatrix site) is mostly building app servers, and from >that context the Twisted documentation is quite hard to grok -- I'd >bet that many potential users don't get past what I took as >the "start here" page:
I think Clark is right here... I started this thread, and the reason why I started it is that I was hoping that someone who knew Webware could tell me what Twisted was all about. I use Webware, and it only took me a casual read of the docs as they were at version 0.4 to understand what it was all about. At the time I was looking at Webware, I also looked at Twisted but gave up because it was rather "inscrutable" (as someone said to me off the list). Since then, I've returned to the Twisted site several times to try to grok it because it was obvious that there were some smart people behind it. But, I always gave up. I felt--rightly or wrongly--that if I couldn't figure it out in an hour or two (like Webware), then chances were that there would be trouble with the docs. This thread has been very interesting so far, thanks to everyone for the high signal-to-noise ratio! ...Edmund. ------------------------------------------------------- This SF.net email is sponsored by: Scholarships for Techies! Can't afford IT training? All 2003 ictp students receive scholarships. Get hands-on training in Microsoft, Cisco, Sun, Linux/UNIX, and more. www.ictp.com/training/sourceforge.asp _______________________________________________ Webware-discuss mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/webware-discuss
