sorted.
add examples and clarify README