cached resolution doc

/review @jsuereth