improve message check for did not change case
enhance documentation