fix a type and expand some points in the readme