updating selection doc to be more coherent...