fixed order of changelog
updated inline docs, added semantic sugar to functions that may fail