add helper function to sort by time dimension #319

Doc changes.