Document API 'sort' field better
#1893

toolness wants to merge document-sort-field into develop

We do not currently have an analysis of these two commits