doc: add docstrings for some js functions loaded within a Gradio app

aip_trainer/lambdas/js.py

@@ -1,4 +1,11 @@
 js_update_ipa_output = """
+/**
+ * Updates the CSS text of the given text based on the correctness of each letter.
+ * 
+ * @param text - The text to be displayed.
+ * @param letters - A string representing the correctness of each letter in the text.
+ * @param idxSelectedWord - The index of the selected word to be underlined.
+ */
 function updateCssText(text, letters, idxSelectedWord) {
     let wordsArr = text.split(" ")
     let lettersWordsArr = letters.split(" ")
@@ -24,6 +31,13 @@ function updateCssText(text, letters, idxSelectedWord) {
 """
 
 js_play_audio = """
+/**
+ * Plays the given text as audio using the Web Speech API.
+ * 
+ * @param text - The text to be spoken.
+ * @param language - The language code for the speech synthesis (e.g., 'en' for English, 'de' for German).
+ * @param sleepTime - Optional. The time in seconds to wait before starting the speech synthesis. Default is 0.
+ */
 function playAudio(text, language, sleepTime = 0) {
     let voice_idx = 0;
     let voice_synth = null;