Dave, This is really great. Two things:
1. Would you be willing to add this to the kafka wiki so we could make this the official howto doc? 2. It might be good to add a "how to contribute your client" section. This would be hard to write right now because we haven't given anyone any guidelines for doing it. We have been pretty liberal in accepting clients kind of proceeding on the "something is better than nothing" theory. But this leads to clients of mixed quality and little documentation, as you and Joe noted. I will break this into a separate thread to broaden the discussion. -Jay On Wed, Nov 23, 2011 at 3:32 PM, David Ormsbee <d...@datadoghq.com> wrote: > Hi folks, > > Inspired by the Wire Format wiki entry, I recently created a draft of > "Writing a Client for Kafka": > > http://readthedocs.org/docs/brod/en/latest/spec.html > > I tried to make it the document that I wish we had at Datadog when we > were total Kafka newbies writing client code. It's still very rough > and littered with "FIXME" notes where I've written things from my > understanding without verifying them with tests. I should be filling > all these gaps in soon, as we're planning to add a lot of > functionality to our Python client in the coming weeks. > > Comments and corrections would be greatly appreciated. :-) > > Thank you very much to the Kafka devs. We've been using Kafka a great > deal at Datadog, we're extremely happy with it, and we're looking > forward to contributing in our own way. We'll make an announcement as > soon as we feel our Python client is ready for community use. > > Take care. > > Dave >