updated examples
added API docs