first stab at api reference, made a few methods private.
add live sample
updated readme to point at sample
fixed callback argument order