updated API docs
add ES example and implement JsonSerializable plus

api docs generation for v1.0.0. refs #3, refs #4, refs #5, refs #7, refs