add documentation for pagination of alarms
grammar fixes in Alarms documentation
Merge pull request #54 from Jiloc/patch-1

add documentation for pagination of alarms