diff --git a/libs/music/shims.d.ts b/libs/music/shims.d.ts
index 9a4a23cc..a624ffee 100644
--- a/libs/music/shims.d.ts
+++ b/libs/music/shims.d.ts
@@ -15,8 +15,8 @@ declare namespace music {
 
     /**
      * Play a tone through the speaker for some amount of time.
-     * @param frequency pitch of the tone to play in Hertz (Hz)
-     * @param ms tone duration in milliseconds (ms)
+     * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C
+     * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half
      */
     //% help=music/play-tone
     //% blockId=music_play_note block="play tone|at %note=device_note|for %duration=device_beat"