Bookkeeper client tutorial

[Ivan Kelly <iv...@apache.org>]

I've spent the last few days putting together a tutorial for the
bookkeeper client. 

https://github.com/ivankelly/bookkeeper-tutorial/

I would be much obliged if people could take a look, run through it and
give me some feedback.

In particular, it would be good it people without much distributed
systems experience could try it, as they are the primary audience.

Also, I have no idea how long it takes to run through.

Best regards,
Ivan

Re: Bookkeeper client tutorial

[Ivan Kelly <iv...@apache.org>]

On 18 October 2014 11:41, Flavio Junqueira <fp...@yahoo.com> wrote:
> I haven't checked the code carefully, but the flow is really good. The discussion about the ZK leader election is possibly a bit too detailed for a tutorial on BK, but otherwise it is good, it gives good insight. It might also be useful as a follow up step to add a discussion on rolling ledgers and deleting ledgers to reclaim space. There is a bit about it in the end, but for a tutorial it doesn't hurt to have more detail.

Ya, rolling is needed. I didn't want to put it into the initial
sections though, as it makes the code harder to follow, especially if
you are learning it. It's like the entryid stuff. It's something very
simple, but kludges up the code a lot.

I think rolling should possibly be another tutorial entirely, as
there's some subtleties around it (like how much to trim?, if there's
multiple followers, who should trim?).

>
> I have pushed a few suggested edits.
I made one comment on it. Otherwise it's ready for merge.

-Ivan

Re: Bookkeeper client tutorial

[Flavio Junqueira <fp...@yahoo.com>]

I haven't checked the code carefully, but the flow is really good. The discussion about the ZK leader election is possibly a bit too detailed for a tutorial on BK, but otherwise it is good, it gives good insight. It might also be useful as a follow up step to add a discussion on rolling ledgers and deleting ledgers to reclaim space. There is a bit about it in the end, but for a tutorial it doesn't hurt to have more detail. 

I have pushed a few suggested edits.

-Flavio

On 10 Oct 2014, at 15:20, Ivan Kelly <iv...@apache.org> wrote:

> I've spent the last few days putting together a tutorial for the
> bookkeeper client. 
> 
> https://github.com/ivankelly/bookkeeper-tutorial/
> 
> I would be much obliged if people could take a look, run through it and
> give me some feedback.
> 
> In particular, it would be good it people without much distributed
> systems experience could try it, as they are the primary audience.
> 
> Also, I have no idea how long it takes to run through.
> 
> Best regards,
> Ivan
> 
>