fixed documentation wrt Jimmys questions