[Doc error] Tutorial 314 External pagination doc makes no sense

[pmariduena]

http://ui-grid.info/docs/#/tutorial/314_external_pagination

The first paragraph of this doc is (verbatim):

When pagination is enabled, the data is displayed in pages that can be browsed using using the built in pagination selector.

For external pagination, handle the paginationChanged' to load the page. Set thegridOptions.totalItems' in the callback.

Can you fix this? Or at least tell me what it means?

[PaulL1]

What would you like it changed to? Would you submit a pull request for it? It seems reasonably clear to me, but I didn't write it.

[pmariduena]

Given my understating of what that last sentence is trying to say, it should say something like: "For external pagination, implement the gridApi.pagination.on.paginationChanged callback function. The callback may contain code to update any pagination state variables your application may utilize, e.g. variables containing the pageNumber and pageSize. The REST call used to fetch the data from the server should be called from within this callback. The URL of the call should contain query parameters that will allow the server-side code to have sufficient information to be able to retrieve the specific subset of data that the client requires from the entire set.

It should also update the $scope.gridOptions.totalItems variable with the total count of rows that exist (but were not all fetched in the REST call mentioned above since they exist in other pages of data).

This will allow ui-grid to calculate the correct number of pages on the client-side."

That is a more complete description of what is going on.