remaining code doc for this ticket. re #8272