Update API documentation
Update API documentation

Update the Pagination section of the API documentation.

Partially fixes bug 1202748

Change-Id: Iec0e6ba47152cef77a30a3464d98516356e04ca4

supermari0/ironic,bacaldwell/ironic,pshchelo/ironic,NaohiroTamura/ironic,ramineni/myironic,NaohiroTamura/ironic,ionutbalutoiu/ironic,naterh/ironic,openstack/ironic,froyobin/ironic,rackerlabs/ironic,dims/ironic,naototty/vagrant-lxc-ironic,rdo-management/ironic,pshchelo/ironic,citrix-openstack-build/ironic,debayanray/ironic_backup,hpproliant/ironic,citrix-openstack-build/ironic,SauloAislan/ironic,ionutbalutoiu/ironic,JioCloud/ironic,Tehsmash/ironic,varunarya10/ironic,faizan-barmawer/openstack_ironic,devananda/ironic,redhat-openstack/ironic,naototty/vagrant-lxc-ironic,dims/ironic,Tan0/ironic,openstack/ironic,bacaldwell/ironic,SauloAislan/ironic