[Twisted-Python] design of twisted application

2011-02-01 Thread Kurt Spindler
Hey, I am trying to design a twisted application, (I'm pretty new to twisted and networking in general) and I feel like I'm not approaching it quite the right way and would appreciate your feedback. First part, is that I am trying to couple twisted with an existing graphics-type application, that

[Twisted-Python] Guidance needed on serial device interaction

2011-02-01 Thread Jason Heeris
This is a bit long, sorry... I have a PyGTK program that uses threads and pyserial's blocking methods to interact with an RS232 connected device. I'd like to throw out the threading awfulness and redo it in Twisted, if possible, but I'm a little lost. The real protocol is a bit convoluted, but ba

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Kevin Horn
On Tue, Feb 1, 2011 at 4:15 PM, Glyph Lefkowitz wrote: > > OK. For what it's worth I share your desire for a new / better term but I > can't think of one. > > Recipes? Snippets? Tidbits? Morsels? Quickies? "How do I..."s? Quick Examples? Simple Examples? Examples? Blurbs? A lot of the va

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Andrew Bennetts
Tom Davis wrote: [...] >* .rpy scripts are for deployment, not debugging; I was a little > concerned seeing that bullet point on the outline. �(See > > <[2]http://twistedmatrix.com/documents/10.2.0/web/howto/web-in-60/rpy-scripts.html>.) > >Huh? The docs you link to

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Glyph Lefkowitz
On Feb 1, 2011, at 10:53 AM, Tom Davis wrote: > On Tue, Feb 1, 2011 at 12:58 PM, Glyph Lefkowitz > wrote: > > On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > >> Thoughts? > > > Priority #1 for most people who are enthusiastic about documentation is to > come in and write a ton of addition

Re: [Twisted-Python] Fingering Finger

2011-02-01 Thread Glyph Lefkowitz
On Feb 1, 2011, at 11:10 AM, Kevin Horn wrote: > I actually found it very helpful back when I was first learning Twisted. I > admit I haven't really read it critically in several years though. If it is > to be removed, I think it would be a good idea to replace it with something > similar (i

Re: [Twisted-Python] Fingering Finger

2011-02-01 Thread Jonathan Ballet
Le Tue, 01 Feb 2011 19:02:15 -, exar...@twistedmatrix.com a écrit : > In an attempt to elicit some feedback on this, let me try casting the > issue in a different light. > > Does anyone think the finger tutorial shouldn't be deleted? Why? I think one of the advantage of this tutorial is th

Re: [Twisted-Python] Fingering Finger

2011-02-01 Thread Andrew Gasson
On 1/02/2011, at 7:10 PM, Kevin Horn wrote: > On Tue, Feb 1, 2011 at 1:02 PM, wrote: > On 22 Jan, 10:14 pm, t...@recursivedream.com wrote: > >In this thread, I hope to find a resolution to the issue of the Finger > >tutorial and efforts to sufficiently improve it or remove it. > > > >In the cour

Re: [Twisted-Python] Fingering Finger

2011-02-01 Thread Kevin Horn
On Tue, Feb 1, 2011 at 1:02 PM, wrote: > On 22 Jan, 10:14 pm, t...@recursivedream.com wrote: > >In this thread, I hope to find a resolution to the issue of the Finger > >tutorial and efforts to sufficiently improve it or remove it. > > > >In the course of reviewing documentation-related tickets,

Re: [Twisted-Python] Fingering Finger

2011-02-01 Thread exarkun
On 22 Jan, 10:14 pm, t...@recursivedream.com wrote: >In this thread, I hope to find a resolution to the issue of the Finger >tutorial and efforts to sufficiently improve it or remove it. > >In the course of reviewing documentation-related tickets, I stumbled >upon >#1148 (http://twistedmatrix.com/

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Tom Davis
On Tue, Feb 1, 2011 at 12:58 PM, Glyph Lefkowitz wrote: > > On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > > Thoughts? > > > Priority #1 for most people who are enthusiastic about documentation is to > come in and write a ton of additional documentation. But this is a lot like > trying to fix a

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Jason J. W. Williams
On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > > Thoughts? Overall I think the layout and structure is a big improvement over the current Twisted documentation. It's easier to navigate and grok where you want to go. While the content of the web tutorial is thin, I think Jean-Paul's Twisted Web i

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Kevin Horn
On Tue, Feb 1, 2011 at 11:55 AM, Glyph Lefkowitz wrote: > > On Jan 31, 2011, at 3:19 PM, exar...@twistedmatrix.com wrote: > > On 10:39 pm, t...@recursivedream.com wrote: > > > Take < > > http://twistedmatrix.com/documents/10.2.0/web/howto/web-in-60/static- > > content.html > > : > > > Tell me the

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Glyph Lefkowitz
On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > Thoughts? Priority #1 for most people who are enthusiastic about documentation is to come in and write a ton of additional documentation. But this is a lot like trying to fix a large, broken, untested system by writing a pile of new, untested

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Glyph Lefkowitz
On Jan 31, 2011, at 3:19 PM, exar...@twistedmatrix.com wrote: > On 10:39 pm, t...@recursivedream.com wrote: >> >> Take < >> http://twistedmatrix.com/documents/10.2.0/web/howto/web-in-60/static- >> content.html >>> : >> >> Tell me the one command I need to serve a directory, *then* show me the

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Albert Brandl
On Tue, Feb 01, 2011 at 09:05:32AM -0500, Tom Davis wrote: > The "breadcrumbs" on the main page look like this: > "Contents :: Serving on the Web HTML, CGI, WSGI, etc." > Might be a problem with the Sphinx configuration. > > Yeah, this is just how the Sphinx template lays thi

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Tom Davis
On Mon, Jan 31, 2011 at 6:19 PM, wrote: > On 10:39 pm, t...@recursivedream.com wrote: > > > >Take < > >http://twistedmatrix.com/documents/10.2.0/web/howto/web-in-60/static- > >content.html > >>: > > > >Tell me the one command I need to serve a directory, *then* show me the > >code > >that one com

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Tom Davis
On Tue, Feb 1, 2011 at 3:44 AM, Albert Brandl wrote: > On Mon, Jan 31, 2011 at 02:41:38PM -0500, Tom Davis wrote: > > Thoughts? > > I think that the overview in the first two sections is very good. It > made me curious to learn more. > > The "breadcrumbs" on the main page look like this: > "Conten

Re: [Twisted-Python] Task-based documentation started

2011-02-01 Thread Albert Brandl
On Mon, Jan 31, 2011 at 02:41:38PM -0500, Tom Davis wrote: > Thoughts? I think that the overview in the first two sections is very good. It made me curious to learn more. The "breadcrumbs" on the main page look like this: "Contents :: Serving on the Web — HTML, CGI, WSGI, etc. » " Might be