bin/alarm: add comments, rephrase some sentences
update notes.