fix typos, less short and more idomatic variable names, package comments, etc.
why doesn't the std lib have this???