add documentation for pagination of alarms