started to revamp the readme and add clearer docs