more documentation housekeeping