improve page ordering

[Schlaefer]

• fix and extend documentation #275
• default to "asc" if no sort order is provided
• trigger warning instead of failing silently if sort type isn't recognized
• fix and extend test cases

[james2doyle]

Any reason not to merge this?

[Frodox]

I think - no. +1