readme updated, tests added, doc updated