cleanup and comments
update min
add reduced on a reduced result example
add note on speed of the library