diff --git a/smnp.music.tools.md b/smnp.music.tools.md
index 5d530a7..11f8cbe 100644
--- a/smnp.music.tools.md
+++ b/smnp.music.tools.md
@@ -1,4 +1,16 @@
 # Functions
 ## `metronome(bpm: int = 120, beats: int = 4, accent: note = @A#2, beat: note = @F#2)`
+Starts a metronome with given tempo, beats and notes acting as an accent and regular beat.
+The notes are played by MIDI sequencer at 10th channel, so these notes are actually a drums sounds.
+
 ## `alert(melody: string = "beep")`
-## `alert(cycles: int, melody: string = "beep")`
\ No newline at end of file
+Runs infinite alert of given melody.
+
+Available melodies:
+* `beep`
+* `bell`
+* `alarm1`
+* `alarm2`
+
+## `alert(cycles: int, melody: string = "beep")`
+The same as `alert(melody: string = "beep")`, however, it runs with given number of times.
\ No newline at end of file