updates of readme, documenation of code