Добавить параметр, например, &limitOnPage для pdoPage, который бы работал также как и &limit, но если задан &limitOnPage, то параметр &limit не учитывался бы для pdoPage.
Дело в том, что параметр &limit, есть и в других сниппетах, например, pdoResources и параметр одинаковый может мешать, например, https://modx.pro/help/5531
Возможно, это не часто требуется, но если добавить не трудно, и логика не сильно поменяется, то параметр &limitOnPage для pdoPage стоит добавить, и в доку, само собой.