updated read me, tests and docs