update comment

dotcom-rendering/src/components/AudioPlayer/components/WaveForm.tsx

@@ -3,13 +3,14 @@ import { useId, useMemo } from 'react';
 const sumArray = (array: number[]) => array.reduce((a, b) => a + b, 0);
 
 /**
- * Pseudo random number generator ([linear congruential
+ * Pseudo random number generator generator ([linear congruential
  * generator](https://en.wikipedia.org/wiki/Linear_congruential_generator)).
  *
- * I'll be honest, I don't fully understand this, but it generates a random
- * number based on a seed, in this case an array of numbers.
+ * I'll be honest, I don't fully understand it, but it creates a pseudo random
+ * number generator based on a seed, in this case an array of numbers.
  *
- * It's deterministic, so the same seed will always generate the same results.
+ * It's deterministic, so calls to the function it returns will always return
+ * the same results.
  *
  * Copilot helped me with it...
  */
@@ -36,11 +37,13 @@ function shuffle(array: number[]) {
 	return array.sort(() => getSeededRandomNumber() - getSeededRandomNumber());
 }
 
+// normalize the amplitude of the fake audio data
 const normalizeAmplitude = (data: number[]) => {
 	const multiplier = Math.pow(Math.max(...data), -1);
 	return data.map((n) => n * multiplier * 100);
 };
 
+/** Returns a string of the specified length, repeating the input string as necessary. */
 function padString(str: string, length: number) {
 	// Repeat the string until it is longer than the desired length
 	const result = str.repeat(Math.ceil(length / str.length));