Documentation: expand explanations about "alarms"

[melissawm]

Alarms are mentioned and used several times in the documentation pages. We could have a dedicated section explaining why they are useful, how to use them and other relevant details.