diff --git a/docs/reference/music/change-tempo-by.md b/docs/reference/music/change-tempo-by.md
index bf7e0cd3..da6fecf7 100644
--- a/docs/reference/music/change-tempo-by.md
+++ b/docs/reference/music/change-tempo-by.md
@@ -13,7 +13,9 @@ music.changeTempoBy(20)
 
 ### Parameters
 
-* a [number](/reference/types/number) that says how much to change the bpm (beats per minute, or number of beats in a minute of the music that the micro:bit is playing).
+* ``bpm`` is a [number](/reference/types/number) that says how much to
+  change the bpm (beats per minute, or number of beats in a minute of
+  the music that the micro:bit is playing).
 
 ### Examples
 
diff --git a/docs/reference/music/play-tone.md b/docs/reference/music/play-tone.md
index f7901f0f..44d7fb37 100644
--- a/docs/reference/music/play-tone.md
+++ b/docs/reference/music/play-tone.md
@@ -12,8 +12,8 @@ music.playTone(440, 120)
 
 ### Parameters
 
-* `Hz` is the [Number](/reference/types/number) of Hertz (the frequency, how high or low the tone is).
-* `ms` is the [Number](/reference/types/number) of milliseconds that the tone lasts.
+* ``frequency`` is the [number](/reference/types/number) of Hertz (how high or low the tone is).
+* ``ms`` is the [number](/reference/types/number) of milliseconds that the tone lasts
 
 ## Example
 
diff --git a/docs/reference/music/rest.md b/docs/reference/music/rest.md
index fd3352a4..87db203a 100644
--- a/docs/reference/music/rest.md
+++ b/docs/reference/music/rest.md
@@ -12,7 +12,9 @@ music.rest(400)
 
 ### Parameters
 
-* a [number](/reference/types/number) saying how many milliseconds the micro:bit should rest. One second is 1000 milliseconds.
+* ``ms`` is a [number](/reference/types/number) saying how many
+  milliseconds the micro:bit should rest. One second is 1000
+  milliseconds.
 
 ## Example
 
diff --git a/docs/reference/music/ring-tone.md b/docs/reference/music/ring-tone.md
index 72853be8..a5cbbd0e 100644
--- a/docs/reference/music/ring-tone.md
+++ b/docs/reference/music/ring-tone.md
@@ -13,8 +13,8 @@ music.ringTone(440)
 
 ### Parameters
 
-* a [number](/reference/types/number) that says the tone's
-**frequency** (how high-pitched or low-pitched the tone is).  This
+* ``frequency`` is a [number](/reference/types/number) that says
+how high-pitched or low-pitched the tone is.  This
 number is in **Hz** (**Hertz**), which is a measurement of frequency
 or pitch.
 
diff --git a/docs/reference/music/set-tempo.md b/docs/reference/music/set-tempo.md
index 41e8b2b5..81dedd67 100644
--- a/docs/reference/music/set-tempo.md
+++ b/docs/reference/music/set-tempo.md
@@ -11,7 +11,7 @@ This function only works on the micro:bit and in some browsers.
 
 ### Parameters
 
-* a [number](/reference/types/number) that means the bpm you want (beats per minute, or number of beats in a minute of the music that the micro:bit is playing).
+* ``bpm`` is a [number](/reference/types/number) that means the beats per minute you want (the number of beats in a minute of the music that the micro:bit is playing).
 
 ### See also
 
diff --git a/docs/reference/music/tempo.md b/docs/reference/music/tempo.md
index 830f14c3..eb5ac5f9 100644
--- a/docs/reference/music/tempo.md
+++ b/docs/reference/music/tempo.md
@@ -8,7 +8,8 @@ music.tempo()
 
 ### Returns
 
-* a [Number](/reference/types/number) that means the bpm (beats per minute, or number of beats in a minute of the music that the micro:bit is playing).
+* a [number](/reference/types/number) that means the beats per minute (number of
+  beats in a minute of the music that the micro:bit is playing).
 
 ### See also