Re: example of proton documentation

2013-02-26 Thread Rafael Schloming
On Tue, Feb 26, 2013 at 8:02 AM, Alan Conway wrote: > This is a good start! We should start a proton book so this has a place > to live. The Qpid books are in docbook under qpid/doc/book. I'm not a > huge fan of docbook but probably best to stick with it unless there's > something significantly b

Re: example of proton documentation

2013-02-26 Thread Alan Conway
This is a good start! We should start a proton book so this has a place to live. The Qpid books are in docbook under qpid/doc/book. I'm not a huge fan of docbook but probably best to stick with it unless there's something significantly better. A few comments on the content: On Fri, 2013-02-22 at

Re: example of proton documentation

2013-02-26 Thread Michael Goulish
ord. I'll get a new version of the doc out in an hour or so. -- Mick . - Original Message - From: "Jakub Scholz" To: proton@qpid.apache.org Sent: Monday, February 25, 2013 6:25:29 PM Subject: Re: example of proton documentation Hi Michael, I&

Re: example of proton documentation

2013-02-25 Thread Jakub Scholz
Hi Michael, I'm rather a foreigner in the land of Proton, but that point of view might make the feedback useful as well :-). As someone who didn't worked with proton much, I would probably raise following questions ... a) If I remember correctly, in (some of) the old Qpid APIs the flow control wa

Re: example of proton documentation

2013-02-22 Thread Phil Harvey
Hi Michael, Looks like a good start. Where are you intending to store this documentation? Similarly, where are you intending to publish it, e.g. as HTML and/or PDF on our web site, as a wiki page etc? I'm particularly interested in this topic because I'm focusing on the lower level Engine layer