readme and docs updates