Behold, there be documentations

 - also, minor code changes