Adjustments made to the files in Sprint-2/1-key-errors to fix key errors and improve code functionality. The commit includes modifications to 0.js, 1.js, and 2.js to address variable declaration issues and parameter naming conventions.

Author: FarancisGH

Sprint-2/1-key-errors/0.js

@@ -1,13 +1,25 @@
 // Predict and explain first...
 //  =============> write your prediction here
+// The command is to capitalise the first letter of the string. 
 
 // call the function capitalise with a string input
-// interpret the error message and figure out why an error is occurring
+// The code will produce an error before the function runs properly. The error message will say, SyntaxError: Identifier 'str' has already been declared
+
+// interpret the error message and figure out why an error is occurring. 
+// The error is occurring because the variable str is being declared twice in the function. The first declaration is in the function parameter, and the second declaration is inside the function body. This causes a conflict because you cannot declare a variable with the same name in the same scope.
 
 function capitalise(str) {
   let str = `${str[0].toUpperCase()}${str.slice(1)}`;
   return str;
 }
 
 // =============> write your explanation here
+// The function capitalise takes a string input and attempts to capitalise the first letter of the string. However, the variable str is declared twice, which causes a SyntaxError. To fix this, we can remove the second declaration of str inside the function body and directly return the capitalised string.
 // =============> write your new code here
+// The corrected function should look like this:
+
+function capitalise(str) {
+  return `${str[0].toUpperCase()}${str.slice(1)}`;
+}
+
+// Now the function should work correctly and capitalise the first letter of the input string.

Sprint-2/1-key-errors/1.js

@@ -1,9 +1,12 @@
 // Predict and explain first...
 
 // Why will an error occur when this program runs?
+// The error occurs because the variable decimalNumber is declared twice in the function convertToPercentage. The first declaration is in the function parameter, and the second declaration is inside the function body. This causes a conflict because you cannot declare a variable with the same name in the same scope.
 // =============> write your prediction here
+// The command is to convert a decimal number to a percentage.
 
 // Try playing computer with the example to work out what is going on
+//
 
 function convertToPercentage(decimalNumber) {
   const decimalNumber = 0.5;
@@ -15,6 +18,16 @@ function convertToPercentage(decimalNumber) {
 console.log(decimalNumber);
 
 // =============> write your explanation here
+// The function convertToPercentage takes a decimal number as input and attempts to convert it to a percentage. However, the variable decimalNumber is declared twice, which causes a SyntaxError. To fix this, we can remove the second declaration of decimalNumber inside the function body and directly return the calculated percentage.
 
 // Finally, correct the code to fix the problem
 // =============> write your new code here
+// The corrected function should look like this:
+
+function convertToPercentage(decimalNumber) {
+  const percentage = `${decimalNumber * 100}%`;
+
+  return percentage;
+}
+
+// Now the function should work correctly and convert a decimal number to a percentage.

Sprint-2/1-key-errors/2.js

@@ -4,17 +4,25 @@
 // this function should square any number but instead we're going to get an error
 
 // =============> write your prediction of the error here
+// The error occurs because the parameter name '3' is not a valid identifier in JavaScript. Variable and parameter names cannot start with a number. This will cause a SyntaxError when the code is parsed.
 
 function square(3) {
     return num * num;
 }
 
 // =============> write the error message here
+// The error message will be: SyntaxError: Unexpected number '3'. This indicates that the parser encountered an unexpected token, which is the number '3' used as a parameter name.
 
 // =============> explain this error message here
+// The error message indicates that the parser is expecting a valid identifier for the parameter name, but it encountered a number instead. In JavaScript, variable and parameter names must start with a letter, underscore, or dollar sign, and cannot start with a number. Therefore, using '3' as a parameter name is not allowed and results in a SyntaxError.
 
 // Finally, correct the code to fix the problem
 
 // =============> write your new code here
+function square(num) {
+    return num * num;
+}
+
+// Now the function should work correctly and return the square of the input number.