add documentation for pagination of alarms

than the second one, you'll get .. is better