adding initial documentation on sorting.