extended readme
documentation work
code cleanup