doco(sort): clarify sort semantics for menu, fix #1688
Merge pull request #1709 from PaulL1/1688_sorting_by_menu

doco(sort): clarify sort semantics for menu, fix #1688