expanded read.me, so hopefully someone can find this useful