docs
break on valid index choice selection
add note about sort
notes
no need to guard with slf4j style logger