improved comments
typo fixes
renamed functions performing mutation f using ! -convetion