You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@qpid.apache.org by Alan Conway <ac...@redhat.com> on 2018/04/30 20:24:59 UTC
Advanced proton C documentation
I've written some small bits of proton-C documentation on multi-threading
and buffering. I plan to include them in the next release and would
appreciate any feedback that might help improve them.
Thanks,
Alan.
Re: Advanced proton C documentation
Posted by Alan Conway <ac...@redhat.com>.
On Fri, May 4, 2018 at 9:23 AM, Ben Hardesty <bh...@redhat.com> wrote:
> Just one suggestion: with developer documentation it's always helpful to
> include examples that demonstrate what you're describing.
Fully agreed, will try to add some examples on the next pass.
> For example, the
> Python Requests library doc uses this technique pretty effectively:
>
> http://docs.python-requests.org/en/latest/user/advanced/
>
> On Thu, May 3, 2018 at 4:18 PM, Alan Conway <ac...@redhat.com> wrote:
>
> > On Wed, May 2, 2018 at 7:01 AM, Robbie Gemmell <robbie.gemmell@gmail.com
> >
> > wrote:
> >
> > > I'm not likely to be much use on that, but a link to or description or
> > > where the changes are might help for folks that can be.
> > >
> >
> > Doh! https://alanconway.github.io/
> >
> >
> > > On 30 April 2018 at 21:24, Alan Conway <ac...@redhat.com> wrote:
> > > > I've written some small bits of proton-C documentation on
> > multi-threading
> > > > and buffering. I plan to include them in the next release and would
> > > > appreciate any feedback that might help improve them.
> > > >
> > > > Thanks,
> > > > Alan.
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
> > > For additional commands, e-mail: users-help@qpid.apache.org
> > >
> > >
> >
>
>
>
> --
>
> BEN HARDESTY
>
> TECHNICAL WRITER, CUSTOMER CONTENT SERVICES
>
> Red Hat
>
> <https://www.redhat.com/>
>
> bhardest@redhat.com M: 412.913.3316 IM: bhardest
> <https://red.ht/sig>
> TRIED. TESTED. TRUSTED. <https://redhat.com/trusted>
>
Re: Advanced proton C documentation
Posted by Ben Hardesty <bh...@redhat.com>.
Just one suggestion: with developer documentation it's always helpful to
include examples that demonstrate what you're describing. For example, the
Python Requests library doc uses this technique pretty effectively:
http://docs.python-requests.org/en/latest/user/advanced/
On Thu, May 3, 2018 at 4:18 PM, Alan Conway <ac...@redhat.com> wrote:
> On Wed, May 2, 2018 at 7:01 AM, Robbie Gemmell <ro...@gmail.com>
> wrote:
>
> > I'm not likely to be much use on that, but a link to or description or
> > where the changes are might help for folks that can be.
> >
>
> Doh! https://alanconway.github.io/
>
>
> > On 30 April 2018 at 21:24, Alan Conway <ac...@redhat.com> wrote:
> > > I've written some small bits of proton-C documentation on
> multi-threading
> > > and buffering. I plan to include them in the next release and would
> > > appreciate any feedback that might help improve them.
> > >
> > > Thanks,
> > > Alan.
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
> > For additional commands, e-mail: users-help@qpid.apache.org
> >
> >
>
--
BEN HARDESTY
TECHNICAL WRITER, CUSTOMER CONTENT SERVICES
Red Hat
<https://www.redhat.com/>
bhardest@redhat.com M: 412.913.3316 IM: bhardest
<https://red.ht/sig>
TRIED. TESTED. TRUSTED. <https://redhat.com/trusted>
Re: Advanced proton C documentation
Posted by Alan Conway <ac...@redhat.com>.
On Wed, May 2, 2018 at 7:01 AM, Robbie Gemmell <ro...@gmail.com>
wrote:
> I'm not likely to be much use on that, but a link to or description or
> where the changes are might help for folks that can be.
>
Doh! https://alanconway.github.io/
> On 30 April 2018 at 21:24, Alan Conway <ac...@redhat.com> wrote:
> > I've written some small bits of proton-C documentation on multi-threading
> > and buffering. I plan to include them in the next release and would
> > appreciate any feedback that might help improve them.
> >
> > Thanks,
> > Alan.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
> For additional commands, e-mail: users-help@qpid.apache.org
>
>
Re: Advanced proton C documentation
Posted by Robbie Gemmell <ro...@gmail.com>.
I'm not likely to be much use on that, but a link to or description or
where the changes are might help for folks that can be.
On 30 April 2018 at 21:24, Alan Conway <ac...@redhat.com> wrote:
> I've written some small bits of proton-C documentation on multi-threading
> and buffering. I plan to include them in the next release and would
> appreciate any feedback that might help improve them.
>
> Thanks,
> Alan.
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org