On Jun 13, 2011, at 8:26 AM, [email protected] wrote: > On 12 Jun, 01:34 pm, [email protected] wrote: >>> This is really why we introduced endpoints - to make it possible for >>> applications to listen on (or connect to) an address that is specified >>> elsewhere. Previously, the "easy thing to do" was to only support >>> TCP/IPv4. With endpoints, the "easy thing to do" is to work with any >>> address family/transport type that there is now (or will be in the >>> future!) an endpoint for. >> >> That's a perfect explanation, many thanks! >>>> I will be giving a training on Twisted in a few days during the >>>> EuroPython conference (actually, more of an assisted tutorial than a >>>> training) and I'm not sure how I should present this. Any information >>>> would be helpful. >>>> >>>> Orestis >>> >>> Hope this helps! Good luck with the session. :) >> >> Thanks. BTW, I've spent the past week browsing through twisted's >> documentation (esp. the API reference). I have a few ideas that I think >> would help newcomers find their away around much easier (and be less >> scared of twisteD). The ideas are mostly organisational, the material >> is there, if one knows what to look for. Should I create new tickets or >> mail ideas to this list? > > It would probably be best if you could get Kevin Horn and/or Tom Davis' > attention. They've both been thinking about making the documentation > more accessible lately. It would be great to incorporate your ideas > into the overall plan.
My ears, they burn! But, yeah, in terms of discoverability, the ever-near lore-to-Sphinx conversion does a ton for discoverability and makes obvious a number of opportunities for organizational improvement (a link to a recentish build eludes me, but when you seem them you'll know what I mean). Beyond the low-hanging fruit, there are many notes regarding individual docs improvements. Feel free to share your own, though I recommend checking Trac first because many documents do indeed have tickets. If you need help there let me know. Speaking of the lore-to-Sphinx conversion, I am contractually obligated to inform you that improvements to current documentation is not blocked by the pending conversion. And that you have the right to a lawyer. Cheers, Tom > Jean-Paul > > _______________________________________________ > Twisted-Python mailing list > [email protected] > http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python _______________________________________________ Twisted-Python mailing list [email protected] http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
