Hi, David,

At LinkedIn, committers are too busy to write a Kafka book right now. I
think this is a good idea to pursue. So, if you want to do it, we'd be
happy to help. The only request that I have for you is while writing the
book, it would be good if you can use this opportunity to also help us
improve the documentation of the site.

Thanks,

Jun

On Tue, Mar 19, 2013 at 6:34 AM, David Arthur <[EMAIL PROTECTED]> wrote:

> I was approached by a publisher the other day to do a book on Kafka -
> something I've actually thought about pursuing. Before I say yes (or
> consider saying yes), I wanted to make sure no one else was working on a
> book. No sense in producing competing texts at this point.
>
> So, anyone working on a Kafka book? Self published or otherwise?
>
> -David
>
>
>

 

I guess the challenge would be that kafka is still in version 0.8, so by
the time your book comes out they might be at version 1.0 i.e. its a moving
target

Sounds like a great idea though!
On Tue, Mar 19, 2013 at 12:20 PM, Jun Rao <[EMAIL PROTECTED]> wrote:

> Hi, David,
>
> At LinkedIn, committers are too busy to write a Kafka book right now. I
> think this is a good idea to pursue. So, if you want to do it, we'd be
> happy to help. The only request that I have for you is while writing the
> book, it would be good if you can use this opportunity to also help us
> improve the documentation of the site.
>
> Thanks,
>
> Jun
>
> On Tue, Mar 19, 2013 at 6:34 AM, David Arthur <[EMAIL PROTECTED]> wrote:
>
> > I was approached by a publisher the other day to do a book on Kafka -
> > something I've actually thought about pursuing. Before I say yes (or
> > consider saying yes), I wanted to make sure no one else was working on a
> > book. No sense in producing competing texts at this point.
> >
> > So, anyone working on a Kafka book? Self published or otherwise?
> >
> > -David
> >
> >
> >
>

 

Hi Jun,

I've been thinking for a while about how to contribute to the project and
thought that working on some documentation for the website might be a good
way. Do you have an outline of what you'd like the site to look like that I
(AND OTHERS hint, hint) could pick a topic, write the article and submit
for you guys to review?
Thanks,

Chris
On Tue, Mar 19, 2013 at 12:20 PM, Jun Rao <[EMAIL PROTECTED]> wrote:

> Hi, David,
>
> At LinkedIn, committers are too busy to write a Kafka book right now. I
> think this is a good idea to pursue. So, if you want to do it, we'd be
> happy to help. The only request that I have for you is while writing the
> book, it would be good if you can use this opportunity to also help us
> improve the documentation of the site.
>
> Thanks,
>
> Jun
>
> On Tue, Mar 19, 2013 at 6:34 AM, David Arthur <[EMAIL PROTECTED]> wrote:
>
> > I was approached by a publisher the other day to do a book on Kafka -
> > something I've actually thought about pursuing. Before I say yes (or
> > consider saying yes), I wanted to make sure no one else was working on a
> > book. No sense in producing competing texts at this point.
> >
> > So, anyone working on a Kafka book? Self published or otherwise?
> >
> > -David
> >
> >
> >
>

 

That's a great idea, Chris! How about picking the quickstart document ?That
is the most important information that users moving to 0.8 will need.

Thanks,
Neha
On Tue, Mar 19, 2013 at 1:31 PM, Chris Curtin <[EMAIL PROTECTED]>wrote:

> Hi Jun,
>
> I've been thinking for a while about how to contribute to the project and
> thought that working on some documentation for the website might be a good
> way. Do you have an outline of what you'd like the site to look like that I
> (AND OTHERS hint, hint) could pick a topic, write the article and submit
> for you guys to review?
>
>
> Thanks,
>
> Chris
>
>
> On Tue, Mar 19, 2013 at 12:20 PM, Jun Rao <[EMAIL PROTECTED]> wrote:
>
> > Hi, David,
> >
> > At LinkedIn, committers are too busy to write a Kafka book right now. I
> > think this is a good idea to pursue. So, if you want to do it, we'd be
> > happy to help. The only request that I have for you is while writing the
> > book, it would be good if you can use this opportunity to also help us
> > improve the documentation of the site.
> >
> > Thanks,
> >
> > Jun
> >
> > On Tue, Mar 19, 2013 at 6:34 AM, David Arthur <[EMAIL PROTECTED]> wrote:
> >
> > > I was approached by a publisher the other day to do a book on Kafka -
> > > something I've actually thought about pursuing. Before I say yes (or
> > > consider saying yes), I wanted to make sure no one else was working on
> a
> > > book. No sense in producing competing texts at this point.
> > >
> > > So, anyone working on a Kafka book? Self published or otherwise?
> > >
> > > -David
> > >
> > >
> > >
> >
>

 

Fantastic!

Who is the target audience for the book, 0.7.2 users migrating to 0.8 or
potential users of 0.8? Let me suggest a 2nd topic catering to the latter
audience: getting from a dev environment (as described in the quickstart
doc) to a production environment, with Zk/brokers/etc. deployed on
different nodes, including replication and failover. In my experience with
pitching Kafka inside 2 different companies engineers & decision makers
with no first hand experience with Kafka will have a hard time buying in
in absence of seeing the path all the way to production. In addition,
replication and management of failures would also cater to 0.7.2 users,
for whom these are new as well. Just a thought :)

-Dragos

On 3/19/13 2:28 PM, "Neha Narkhede" <[EMAIL PROTECTED]> wrote:

>That's a great idea, Chris! How about picking the quickstart document
>?That
>is the most important information that users moving to 0.8 will need.
>
>Thanks,
>Neha
>
>
>On Tue, Mar 19, 2013 at 1:31 PM, Chris Curtin
><[EMAIL PROTECTED]>wrote:
>
>> Hi Jun,
>>
>> I've been thinking for a while about how to contribute to the project
>>and
>> thought that working on some documentation for the website might be a
>>good
>> way. Do you have an outline of what you'd like the site to look like
>>that I
>> (AND OTHERS hint, hint) could pick a topic, write the article and submit
>> for you guys to review?
>>
>>
>> Thanks,
>>
>> Chris
>>
>>
>> On Tue, Mar 19, 2013 at 12:20 PM, Jun Rao <[EMAIL PROTECTED]> wrote:
>>
>> > Hi, David,
>> >
>> > At LinkedIn, committers are too busy to write a Kafka book right now.
>>I
>> > think this is a good idea to pursue. So, if you want to do it, we'd be
>> > happy to help. The only request that I have for you is while writing
>>the
>> > book, it would be good if you can use this opportunity to also help us
>> > improve the documentation of the site.
>> >
>> > Thanks,
>> >
>> > Jun
>> >
>> > On Tue, Mar 19, 2013 at 6:34 AM, David Arthur <[EMAIL PROTECTED]>
>>wrote:
>> >
>> > > I was approached by a publisher the other day to do a book on Kafka
>>-
>> > > something I've actually thought about pursuing. Before I say yes (or
>> > > consider saying yes), I wanted to make sure no one else was working
>>on
>> a
>> > > book. No sense in producing competing texts at this point.
>> > >
>> > > So, anyone working on a Kafka book? Self published or otherwise?
>> > >
>> > > -David
>> > >
>> > >
>> > >
>> >
>>
 

Okay, how do we do this logistically? I've take the Producer code that I
wrote for testing purposes and wrote a description around it. How do I get
it to you guys?

Simple Consumer is going to take a little longer since my test Consumers
are non-trivial and I'll need to simplify them.

Thanks,

Chris
On Tue, Mar 19, 2013 at 5:28 PM, Neha Narkhede <[EMAIL PROTECTED]>wrote:

> That's a great idea, Chris! How about picking the quickstart document ?That
> is the most important information that users moving to 0.8 will need.
>
> Thanks,
> Neha
>
>
>
>

 

Our webpage source is at https://svn.apache.org/repos/asf/kafka/site . You
can file a jira and attach a patch.

Thanks,

Jun

On Wed, Mar 20, 2013 at 12:39 PM, Chris Curtin <[EMAIL PROTECTED]>wrote:

> Okay, how do we do this logistically? I've take the Producer code that I
> wrote for testing purposes and wrote a description around it. How do I get
> it to you guys?
>
> Simple Consumer is going to take a little longer since my test Consumers
> are non-trivial and I'll need to simplify them.
>
> Thanks,
>
> Chris
>
>
> On Tue, Mar 19, 2013 at 5:28 PM, Neha Narkhede <[EMAIL PROTECTED]
> >wrote:
>
> > That's a great idea, Chris! How about picking the quickstart document
> ?That
> > is the most important information that users moving to 0.8 will need.
> >
> > Thanks,
> > Neha
> >
> >
> >
> >
>

 

Thanks for finding those. Looks like a copy and paste issue. I've updated
the document.

Thanks,

Chris
On Sat, Mar 23, 2013 at 11:27 AM, Jonathan Hodges <[EMAIL PROTECTED]> wrote:

> Many thanks for contributing!  The docs are very helpful.  I found a couple
> small possible typos.  The partitioning code example looks like it repeats
> at the bottom with duplicate import and class definition statements.  Also
> the create topic command-line appears to have an extra '-' for the
> partition option.  I can edit these, but before doing so I wanted to check
> and make sure I wasn't mistaken.
>
> -Jonathan
>
>
>
>
>

 

Chris,

This looks good. One thing about partitioning. Currently, if a message
doesn't have a key, we always use the random partitioner (regardless of
what "partitioner.class" is set to).

Thanks,

Jun

On Thu, Mar 21, 2013 at 11:42 AM, Chris Curtin <[EMAIL PROTECTED]>wrote:

> I published my first Wiki example:
>
> https://cwiki.apache.org/confluence/display/KAFKA/0.8.0+Producer+Example
>
> Can you guys take a look and see if the tone, format and of course content
> fit into what you'd like to see?
>
> Also, is there a naming convention we should be following?
>
> Thanks,
>
> Chris
>
>
> On Thu, Mar 21, 2013 at 1:38 PM, Neha Narkhede <[EMAIL PROTECTED]
> >wrote:
>
> > Yes, that works as well.
> >
> > Thanks,
> > Neha
> >
> >
> > On Thu, Mar 21, 2013 at 10:33 AM, Chris Curtin <[EMAIL PROTECTED]
> > >wrote:
> >
> > > Or can I do it in the Wiki until you release 0.8.0 so people can
> comment
> > on
> > > them? I think I can edit the Wiki with my Apache login.
> > >
> > >
> > > On Thu, Mar 21, 2013 at 12:17 AM, Jun Rao <[EMAIL PROTECTED]> wrote:
> > >
> > > > Our webpage source is at https://svn.apache.org/repos/asf/kafka/site.
> > > You
> > > > can file a jira and attach a patch.
> > > >
> > > > Thanks,
> > > >
> > > > Jun
> > > >
> > > >
> > >
> >
>

 

Thanks Jun,

I've updated the example with this information.

I've also removed some of the unnecessary newlines.

Thanks,

Chris
On Mon, Mar 25, 2013 at 12:04 PM, Jun Rao <[EMAIL PROTECTED]> wrote:

> Chris,
>
> This looks good. One thing about partitioning. Currently, if a message
> doesn't have a key, we always use the random partitioner (regardless of
> what "partitioner.class" is set to).
>
> Thanks,
>
> Jun
>
>
>