more cleanups and hacking documentation