docs update with new sort parameter