housekeeping + readme