You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@thrift.apache.org by Diwaker Gupta <di...@maginatics.com> on 2011/03/08 19:49:47 UTC

Thrift: The Missing Guide

Thrift is clearly abundant in features. What is sorely lacking though
is good documentation. Here's my attempt to plug that gap:
http://diwakergupta.github.com/thrift-missing-guide/

The guide is by no means complete. My goal is to collect the most
useful bits of information (from the wiki, mailing lists etc) in a
single place. Part of the motivation for doing this was realizing how
great the Protocol Buffer documentation is compared to that of Thrift.

The source code is available here:
https://github.com/diwakergupta/thrift-missing-guide

Feedback and patches welcome!

cheers,
Diwaker

Re: Thrift: The Missing Guide

Posted by Diwaker Gupta <di...@maginatics.com>.
Thanks Piyush. Note that there have been several additions to the
guide since my last mail on this thread.

cheers,
Diwaker

On Wed, Mar 23, 2011 at 8:43 AM, Piyush Goel
<pi...@capillary.co.in> wrote:
> Great Job !! This is much better the current docs available on thrift !!
>
> On Tue, Mar 15, 2011 at 12:22 PM, Diwaker Gupta <di...@maginatics.com> wrote:
>> Thanks for the positive feedback folks. Feel free to use this thread
>> to add things that you'd like to be covered first.
>>
>> Diwaker
>>
>> On Thu, Mar 10, 2011 at 11:51 AM, Nevo Hed
>> <nh...@bamboo-entertainment.com> wrote:
>>> Not to sound like a broken record, but Awsome!
>>>
>>> (speaking as a freshly-minted thrift user, probably needs more depth)
>>>
>>> Thanks!
>>>
>>> On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <di...@maginatics.com>wrote:
>>>
>>>> Thrift is clearly abundant in features. What is sorely lacking though
>>>> is good documentation. Here's my attempt to plug that gap:
>>>> http://diwakergupta.github.com/thrift-missing-guide/
>>>>
>>>> The guide is by no means complete. My goal is to collect the most
>>>> useful bits of information (from the wiki, mailing lists etc) in a
>>>> single place. Part of the motivation for doing this was realizing how
>>>> great the Protocol Buffer documentation is compared to that of Thrift.
>>>>
>>>> The source code is available here:
>>>> https://github.com/diwakergupta/thrift-missing-guide
>>>>
>>>> Feedback and patches welcome!
>>>>
>>>> cheers,
>>>> Diwaker
>>>>
>>>
>>>
>>>
>>> --
>>> Nevo Hed
>>>
>>> nhed@bamboo-entertainment.com
>>> 617-302-6175
>>>
>>
>

Re: Thrift: The Missing Guide

Posted by Piyush Goel <pi...@capillary.co.in>.
Great Job !! This is much better the current docs available on thrift !!

On Tue, Mar 15, 2011 at 12:22 PM, Diwaker Gupta <di...@maginatics.com> wrote:
> Thanks for the positive feedback folks. Feel free to use this thread
> to add things that you'd like to be covered first.
>
> Diwaker
>
> On Thu, Mar 10, 2011 at 11:51 AM, Nevo Hed
> <nh...@bamboo-entertainment.com> wrote:
>> Not to sound like a broken record, but Awsome!
>>
>> (speaking as a freshly-minted thrift user, probably needs more depth)
>>
>> Thanks!
>>
>> On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <di...@maginatics.com>wrote:
>>
>>> Thrift is clearly abundant in features. What is sorely lacking though
>>> is good documentation. Here's my attempt to plug that gap:
>>> http://diwakergupta.github.com/thrift-missing-guide/
>>>
>>> The guide is by no means complete. My goal is to collect the most
>>> useful bits of information (from the wiki, mailing lists etc) in a
>>> single place. Part of the motivation for doing this was realizing how
>>> great the Protocol Buffer documentation is compared to that of Thrift.
>>>
>>> The source code is available here:
>>> https://github.com/diwakergupta/thrift-missing-guide
>>>
>>> Feedback and patches welcome!
>>>
>>> cheers,
>>> Diwaker
>>>
>>
>>
>>
>> --
>> Nevo Hed
>>
>> nhed@bamboo-entertainment.com
>> 617-302-6175
>>
>

Re: Thrift: The Missing Guide

Posted by Diwaker Gupta <di...@maginatics.com>.
Thanks for the positive feedback folks. Feel free to use this thread
to add things that you'd like to be covered first.

Diwaker

On Thu, Mar 10, 2011 at 11:51 AM, Nevo Hed
<nh...@bamboo-entertainment.com> wrote:
> Not to sound like a broken record, but Awsome!
>
> (speaking as a freshly-minted thrift user, probably needs more depth)
>
> Thanks!
>
> On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <di...@maginatics.com>wrote:
>
>> Thrift is clearly abundant in features. What is sorely lacking though
>> is good documentation. Here's my attempt to plug that gap:
>> http://diwakergupta.github.com/thrift-missing-guide/
>>
>> The guide is by no means complete. My goal is to collect the most
>> useful bits of information (from the wiki, mailing lists etc) in a
>> single place. Part of the motivation for doing this was realizing how
>> great the Protocol Buffer documentation is compared to that of Thrift.
>>
>> The source code is available here:
>> https://github.com/diwakergupta/thrift-missing-guide
>>
>> Feedback and patches welcome!
>>
>> cheers,
>> Diwaker
>>
>
>
>
> --
> Nevo Hed
>
> nhed@bamboo-entertainment.com
> 617-302-6175
>

Re: Thrift: The Missing Guide

Posted by Nevo Hed <nh...@bamboo-entertainment.com>.
Not to sound like a broken record, but Awsome!

(speaking as a freshly-minted thrift user, probably needs more depth)

Thanks!

On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <di...@maginatics.com>wrote:

> Thrift is clearly abundant in features. What is sorely lacking though
> is good documentation. Here's my attempt to plug that gap:
> http://diwakergupta.github.com/thrift-missing-guide/
>
> The guide is by no means complete. My goal is to collect the most
> useful bits of information (from the wiki, mailing lists etc) in a
> single place. Part of the motivation for doing this was realizing how
> great the Protocol Buffer documentation is compared to that of Thrift.
>
> The source code is available here:
> https://github.com/diwakergupta/thrift-missing-guide
>
> Feedback and patches welcome!
>
> cheers,
> Diwaker
>



-- 
Nevo Hed

nhed@bamboo-entertainment.com
617-302-6175

Re: Thrift: The Missing Guide

Posted by Ted Dunning <te...@gmail.com>.
Looks very nice (and SORELY missed).

It would be nice to have a few sample programs.  There is always uncertainty
among new Thrift programmers about which specific classes to use for
Transports and such.  I know I don't know the current dogma on this.

Another thing that is never discussed much is how to use Thrift
serialization to store and read data.

Some examples that show how easy Thrift makes unit testing would be great as
well.



On Tue, Mar 8, 2011 at 10:49 AM, Diwaker Gupta <di...@maginatics.com>wrote:

> Thrift is clearly abundant in features. What is sorely lacking though
> is good documentation. Here's my attempt to plug that gap:
> http://diwakergupta.github.com/thrift-missing-guide/
>
> The guide is by no means complete. My goal is to collect the most
> useful bits of information (from the wiki, mailing lists etc) in a
> single place. Part of the motivation for doing this was realizing how
> great the Protocol Buffer documentation is compared to that of Thrift.
>
> The source code is available here:
> https://github.com/diwakergupta/thrift-missing-guide
>
> Feedback and patches welcome!
>
> cheers,
> Diwaker
>

Re: Thrift: The Missing Guide

Posted by Bjørn Borud <bb...@gmail.com>.
very cool.  I agree, it should be prominently linked on the site.  I'd
prefer to have it in the wiki, but if they maintainer prefers to maintain it
as a separate document that is good too :-)

good work!

-Bjørn

Re: Thrift: The Missing Guide

Posted by Abhishek Kona <ab...@gmail.com>.
On 09/03/11 9:51 AM, Christian Lavoie wrote:
> On Tue, Mar 8, 2011 at 2:25 PM, Diwaker Gupta<di...@maginatics.com>  wrote:
>> On Tue, Mar 8, 2011 at 11:16 AM, Jake Luciani<ja...@gmail.com>  wrote:
>>> Well if you contribute the doc to us once you are happy with it we can
>>> bundle it with the code and put it in thrift.apache.org
>> Absolutely. The doc is open source and I'll put it under an
>> appropriate license shortly.
Greatly appreciated.
A few more examples of Servers (in various language) will be really helpful.
-Abhishek Kona

>> Diwaker
>>
>>> Thanks again!
>>>
>>> -Jake
>>>
>>> On Tue, Mar 8, 2011 at 2:01 PM, Diwaker Gupta<di...@maginatics.com>wrote:
>>>
>>>> On Tue, Mar 8, 2011 at 10:54 AM, Jake Luciani<ja...@gmail.com>  wrote:
>>>>> Awesome!
>>>> Thanks.
>>>>
>>>>> Any reason why you aren't using the Thrift wiki?
>>>> The wiki is great for gathering unstructured information over time,
>>>> but I don't think it works very well for this kind of reference
>>>> documentation. Besides, IMHO the current guide looks a lot more pretty
>>>> than the wiki (thanks to asciidoc!)
>>>>
>>>> Diwaker
>>>>
>>>>>
>>>>> On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta<diwaker@maginatics.com
>>>>> wrote:
>>>>>
>>>>>> Thrift is clearly abundant in features. What is sorely lacking though
>>>>>> is good documentation. Here's my attempt to plug that gap:
>>>>>> http://diwakergupta.github.com/thrift-missing-guide/
>>>>>>
>>>>>> The guide is by no means complete. My goal is to collect the most
>>>>>> useful bits of information (from the wiki, mailing lists etc) in a
>>>>>> single place. Part of the motivation for doing this was realizing how
>>>>>> great the Protocol Buffer documentation is compared to that of Thrift.
>>>>>>
>>>>>> The source code is available here:
>>>>>> https://github.com/diwakergupta/thrift-missing-guide
>>>>>>
>>>>>> Feedback and patches welcome!
>>>>>>
>>>>>> cheers,
>>>>>> Diwaker
>>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> http://twitter.com/tjake
>>>>>
>>>
>>>
>>> --
>>> http://twitter.com/tjake
>>>
>
>


Re: Thrift: The Missing Guide

Posted by Christian Lavoie <ch...@gmail.com>.
On Tue, Mar 8, 2011 at 2:25 PM, Diwaker Gupta <di...@maginatics.com> wrote:
> On Tue, Mar 8, 2011 at 11:16 AM, Jake Luciani <ja...@gmail.com> wrote:
>> Well if you contribute the doc to us once you are happy with it we can
>> bundle it with the code and put it in thrift.apache.org
>
> Absolutely. The doc is open source and I'll put it under an
> appropriate license shortly.

Awesome; much appreciated.

> Diwaker
>
>> Thanks again!
>>
>> -Jake
>>
>> On Tue, Mar 8, 2011 at 2:01 PM, Diwaker Gupta <di...@maginatics.com>wrote:
>>
>>> On Tue, Mar 8, 2011 at 10:54 AM, Jake Luciani <ja...@gmail.com> wrote:
>>> > Awesome!
>>>
>>> Thanks.
>>>
>>> > Any reason why you aren't using the Thrift wiki?
>>>
>>> The wiki is great for gathering unstructured information over time,
>>> but I don't think it works very well for this kind of reference
>>> documentation. Besides, IMHO the current guide looks a lot more pretty
>>> than the wiki (thanks to asciidoc!)
>>>
>>> Diwaker
>>>
>>> >
>>> >
>>> > On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <diwaker@maginatics.com
>>> >wrote:
>>> >
>>> >> Thrift is clearly abundant in features. What is sorely lacking though
>>> >> is good documentation. Here's my attempt to plug that gap:
>>> >> http://diwakergupta.github.com/thrift-missing-guide/
>>> >>
>>> >> The guide is by no means complete. My goal is to collect the most
>>> >> useful bits of information (from the wiki, mailing lists etc) in a
>>> >> single place. Part of the motivation for doing this was realizing how
>>> >> great the Protocol Buffer documentation is compared to that of Thrift.
>>> >>
>>> >> The source code is available here:
>>> >> https://github.com/diwakergupta/thrift-missing-guide
>>> >>
>>> >> Feedback and patches welcome!
>>> >>
>>> >> cheers,
>>> >> Diwaker
>>> >>
>>> >
>>> >
>>> >
>>> > --
>>> > http://twitter.com/tjake
>>> >
>>>
>>
>>
>>
>> --
>> http://twitter.com/tjake
>>
>



-- 
Have fun, Christian
http://linkedin.christianlavoie.net

"I won't let you fall apart."

Re: Thrift: The Missing Guide

Posted by Diwaker Gupta <di...@maginatics.com>.
On Tue, Mar 8, 2011 at 11:16 AM, Jake Luciani <ja...@gmail.com> wrote:
> Well if you contribute the doc to us once you are happy with it we can
> bundle it with the code and put it in thrift.apache.org

Absolutely. The doc is open source and I'll put it under an
appropriate license shortly.

Diwaker

> Thanks again!
>
> -Jake
>
> On Tue, Mar 8, 2011 at 2:01 PM, Diwaker Gupta <di...@maginatics.com>wrote:
>
>> On Tue, Mar 8, 2011 at 10:54 AM, Jake Luciani <ja...@gmail.com> wrote:
>> > Awesome!
>>
>> Thanks.
>>
>> > Any reason why you aren't using the Thrift wiki?
>>
>> The wiki is great for gathering unstructured information over time,
>> but I don't think it works very well for this kind of reference
>> documentation. Besides, IMHO the current guide looks a lot more pretty
>> than the wiki (thanks to asciidoc!)
>>
>> Diwaker
>>
>> >
>> >
>> > On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <diwaker@maginatics.com
>> >wrote:
>> >
>> >> Thrift is clearly abundant in features. What is sorely lacking though
>> >> is good documentation. Here's my attempt to plug that gap:
>> >> http://diwakergupta.github.com/thrift-missing-guide/
>> >>
>> >> The guide is by no means complete. My goal is to collect the most
>> >> useful bits of information (from the wiki, mailing lists etc) in a
>> >> single place. Part of the motivation for doing this was realizing how
>> >> great the Protocol Buffer documentation is compared to that of Thrift.
>> >>
>> >> The source code is available here:
>> >> https://github.com/diwakergupta/thrift-missing-guide
>> >>
>> >> Feedback and patches welcome!
>> >>
>> >> cheers,
>> >> Diwaker
>> >>
>> >
>> >
>> >
>> > --
>> > http://twitter.com/tjake
>> >
>>
>
>
>
> --
> http://twitter.com/tjake
>

Re: Thrift: The Missing Guide

Posted by Jake Luciani <ja...@gmail.com>.
Well if you contribute the doc to us once you are happy with it we can
bundle it with the code and put it in thrift.apache.org

Thanks again!

-Jake

On Tue, Mar 8, 2011 at 2:01 PM, Diwaker Gupta <di...@maginatics.com>wrote:

> On Tue, Mar 8, 2011 at 10:54 AM, Jake Luciani <ja...@gmail.com> wrote:
> > Awesome!
>
> Thanks.
>
> > Any reason why you aren't using the Thrift wiki?
>
> The wiki is great for gathering unstructured information over time,
> but I don't think it works very well for this kind of reference
> documentation. Besides, IMHO the current guide looks a lot more pretty
> than the wiki (thanks to asciidoc!)
>
> Diwaker
>
> >
> >
> > On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <diwaker@maginatics.com
> >wrote:
> >
> >> Thrift is clearly abundant in features. What is sorely lacking though
> >> is good documentation. Here's my attempt to plug that gap:
> >> http://diwakergupta.github.com/thrift-missing-guide/
> >>
> >> The guide is by no means complete. My goal is to collect the most
> >> useful bits of information (from the wiki, mailing lists etc) in a
> >> single place. Part of the motivation for doing this was realizing how
> >> great the Protocol Buffer documentation is compared to that of Thrift.
> >>
> >> The source code is available here:
> >> https://github.com/diwakergupta/thrift-missing-guide
> >>
> >> Feedback and patches welcome!
> >>
> >> cheers,
> >> Diwaker
> >>
> >
> >
> >
> > --
> > http://twitter.com/tjake
> >
>



-- 
http://twitter.com/tjake

Re: Thrift: The Missing Guide

Posted by Diwaker Gupta <di...@maginatics.com>.
On Tue, Mar 8, 2011 at 10:54 AM, Jake Luciani <ja...@gmail.com> wrote:
> Awesome!

Thanks.

> Any reason why you aren't using the Thrift wiki?

The wiki is great for gathering unstructured information over time,
but I don't think it works very well for this kind of reference
documentation. Besides, IMHO the current guide looks a lot more pretty
than the wiki (thanks to asciidoc!)

Diwaker

>
>
> On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <di...@maginatics.com>wrote:
>
>> Thrift is clearly abundant in features. What is sorely lacking though
>> is good documentation. Here's my attempt to plug that gap:
>> http://diwakergupta.github.com/thrift-missing-guide/
>>
>> The guide is by no means complete. My goal is to collect the most
>> useful bits of information (from the wiki, mailing lists etc) in a
>> single place. Part of the motivation for doing this was realizing how
>> great the Protocol Buffer documentation is compared to that of Thrift.
>>
>> The source code is available here:
>> https://github.com/diwakergupta/thrift-missing-guide
>>
>> Feedback and patches welcome!
>>
>> cheers,
>> Diwaker
>>
>
>
>
> --
> http://twitter.com/tjake
>

Re: Thrift: The Missing Guide

Posted by Jake Luciani <ja...@gmail.com>.
Awesome!

Any reason why you aren't using the Thrift wiki?



On Tue, Mar 8, 2011 at 1:49 PM, Diwaker Gupta <di...@maginatics.com>wrote:

> Thrift is clearly abundant in features. What is sorely lacking though
> is good documentation. Here's my attempt to plug that gap:
> http://diwakergupta.github.com/thrift-missing-guide/
>
> The guide is by no means complete. My goal is to collect the most
> useful bits of information (from the wiki, mailing lists etc) in a
> single place. Part of the motivation for doing this was realizing how
> great the Protocol Buffer documentation is compared to that of Thrift.
>
> The source code is available here:
> https://github.com/diwakergupta/thrift-missing-guide
>
> Feedback and patches welcome!
>
> cheers,
> Diwaker
>



-- 
http://twitter.com/tjake