cached resolution doc

/review @jsuereth 
s/or downright impossible/or is downright impossible/