add documentation for pagination of alarms

here too