create a new hash and modify, don't change original; added param documentation