improve readme and docs