i'm finding the documentation extremely interesting... but wonder how much it would be improved with properly named variables :)