documentation + housekeeping