move relevant bits of README into code comments