midway commit: overhaul. some readme