update docs to include associated sorting

closes #1977