nits and comments

It looks like a great start, I added some comments and nits. Ofc you should not take this patch as it is :) just sending this pull request as the easies notification about my suggestions I could come up with.