documentation and readme files updated