simplify

kentcdodds · kentcdodds · commit c9ed6c5e5c4f · 2026-01-27T16:15:57.000-07:00
diff --git a/exercises/01.expressions-and-output/02.problem.escaping-strings/index.ts b/exercises/01.expressions-and-output/02.problem.escaping-strings/index.ts
@@ -2,13 +2,9 @@
 // Learn to include special characters in strings
 
 // 🐨 Log "It's working!" using single quotes (you'll need to escape the apostrophe)
-// 💰 Use the correct escape sequence for an apostrophe
 
 // 🐨 Log: She said "Hi" (using double quotes for the string)
-// 💰 Use an escape sequence for the inner quotes
 
 // 🐨 Log "Hello" and "World" on separate lines using a single string with \n
-// 💰 Use the newline escape sequence
 
 // 🐨 Log tab-separated data: Name: [tab] Age: [tab] City: (like column headers)
-// 💰 Use the tab escape sequence between words
diff --git a/exercises/01.expressions-and-output/05.problem.template-literals/index.ts b/exercises/01.expressions-and-output/05.problem.template-literals/index.ts
@@ -2,9 +2,7 @@
 // A better way to build strings
 
 // 🐨 Log "The answer is 42" using a template literal with ${40 + 2}
-// 💰 Use a template literal with interpolation for the expression
 
 // 🐨 Log "Hello, TypeScript!" using a template literal
 
 // 🐨 Log a math problem like "10 times 5 equals 50"
-// 💰 Compute the result inside the template literal
diff --git a/exercises/02.variables/01.problem.let-and-const/index.ts b/exercises/02.variables/01.problem.let-and-const/index.ts
@@ -17,7 +17,7 @@
 // 🐨 Add the muffin to the cart (update cartTotal)
 
 // 🐨 Calculate the final total with tax
-// 💰 Calculate the tax from cartTotal and add it to get finalTotal
+// 💰 Include tax when computing the final total
 
 // 🐨 Try uncommenting the line below - what happens?
 // TAX_RATE = 0.10
diff --git a/exercises/02.variables/02.problem.reassignment-vs-mutation/index.ts b/exercises/02.variables/02.problem.reassignment-vs-mutation/index.ts
@@ -10,10 +10,8 @@ console.log('Original person:', person)
 // 💣 Uncomment the line above and see the TypeScript error
 
 // 🐨 Now try MUTATING the object by changing the age property
-// 💰 Update the age property on the existing object
 
 // 🐨 Mutate again by changing the city
-// 💰 Update the city property on the existing object
 
 console.log('Modified person:', person)
 
diff --git a/exercises/03.primitive-types/01.problem.numbers-and-strings/index.ts b/exercises/03.primitive-types/01.problem.numbers-and-strings/index.ts
@@ -9,7 +9,6 @@
 
 // 🐨 Create a `description` using a template literal that outputs:
 // "Product: TypeScript Guide | Price: $29.99 | In Stock: 100"
-// 💰 Use a template literal with interpolation
 
 // ✅ These console.logs will verify your work
 // console.log('Price:', price)
diff --git a/exercises/03.primitive-types/03.problem.booleans-and-comparisons/index.ts b/exercises/03.primitive-types/03.problem.booleans-and-comparisons/index.ts
@@ -7,13 +7,10 @@ const stockCount: number = 100
 // 🐨 Create a variable `isAvailable` with type `boolean` set to `true`
 
 // 🐨 Create a variable `hasDiscount` that's true when price is under 50
-// 💰 Use a comparison based on the price
 
 // 🐨 Create a variable `canPurchase` that's true when isAvailable AND stockCount > 0
-// 💰 Combine conditions so both must be true
 
 // 🐨 Create a variable `isNotAvailable` that's the opposite of `isAvailable`
-// 💰 Invert the boolean
 
 // ✅ Verification
 // @ts-expect-error - 💣 remove this comment
diff --git a/exercises/03.primitive-types/05.problem.bigint-and-symbol/index.ts b/exercises/03.primitive-types/05.problem.bigint-and-symbol/index.ts
@@ -3,15 +3,12 @@
 
 // 🐨 Create a bigint variable `largeNumber` with the value 9007199254740993n
 // This is larger than Number.MAX_SAFE_INTEGER!
-// 💰 Use a bigint literal with the `n` suffix
 
 // 🐨 Create another bigint `anotherLarge` with value 1000000000000000000n
 
 // 🐨 Add them together into a variable called `sum`
-// 💰 Add the two bigint values together
 
 // 🐨 Create a symbol called `userId` with description 'user-id'
-// 💰 Create a symbol with the given description
 
 // 🐨 Create another symbol called `anotherId` with the same description 'user-id'
 
diff --git a/exercises/03.primitive-types/06.problem.truthy-falsy/index.ts b/exercises/03.primitive-types/06.problem.truthy-falsy/index.ts
@@ -11,7 +11,6 @@ const cartTotal = 42
 const hasAcceptedTerms = false
 
 // 🐨 Create a variable `hasUsername` based on the truthiness of `username`
-// 💰 Convert the value to a boolean
 
 // 🐨 Create a variable `hasNickname` based on the truthiness of `nickname`
 
diff --git a/exercises/04.control-flow/01.problem.conditionals/index.ts b/exercises/04.control-flow/01.problem.conditionals/index.ts
@@ -4,7 +4,6 @@
 const score: number = 85
 
 // 🐨 Create a variable `grade` of type string
-// 💰 let grade: string
 
 // 🐨 Write if/else if/else to set the grade:
 // - 90 and above: "A"
@@ -14,7 +13,6 @@ const score: number = 85
 // - Below 60: "F"
 
 // 🐨 Create a variable `passed` that is true if grade is C or above
-// 💰 A passing grade is C or above
 
 // console.log(`Score: ${score}`)
 // console.log(`Grade: ${grade}`)
diff --git a/exercises/04.control-flow/02.problem.switch-statements/index.ts b/exercises/04.control-flow/02.problem.switch-statements/index.ts
@@ -4,7 +4,6 @@
 const grade: string = 'B'
 
 // 🐨 Create a variable `description` of type string
-// 💰 let description: string
 
 // 🐨 Write a switch statement on `grade`:
 // - case 'A': set description to "Excellent"
@@ -13,7 +12,7 @@ const grade: string = 'B'
 // - case 'D': set description to "Needs Improvement"
 // - case 'F': set description to "Failing"
 // - default: set description to "Invalid grade"
-// 💰 Don't forget the `break` after each case!
+// 💰 Each case should avoid falling through
 
 // console.log(`Grade ${grade}: ${description}`)
 
diff --git a/exercises/04.control-flow/03.problem.loops/index.ts b/exercises/04.control-flow/03.problem.loops/index.ts
@@ -2,7 +2,6 @@
 // Using a for loop to build a numbered list
 
 // 🐨 Create a variable `exhibitLabels` starting as an empty string
-// 💰 Start with an empty string
 
 // 🐨 Write a for loop that counts from 1 to 5
 // 🐨 On each pass, add a line like "Exhibit 1" to the string
diff --git a/exercises/04.control-flow/04.problem.nested-loops/index.ts b/exercises/04.control-flow/04.problem.nested-loops/index.ts
@@ -5,7 +5,6 @@ const rows = ['A', 'B', 'C']
 const seatsPerRow = 4
 
 // 🐨 Create a variable `seatChart` starting as an empty string
-// 💰 Start with an empty string
 
 // 🐨 Use nested for loops to build the seating chart
 // 🐨 Each row should include seat labels like "A1 A2 A3 A4"
diff --git a/exercises/04.control-flow/05.problem.ternary-operator/index.ts b/exercises/04.control-flow/05.problem.ternary-operator/index.ts
@@ -5,13 +5,11 @@ const temperature = 25
 
 // 🐨 Create a variable `weatherDescription` using a ternary operator
 // It should be "hot" if temperature > 30, otherwise "comfortable"
-// 💰 Use a ternary to choose between two values
 
 const score = 85
 
 // 🐨 Create a variable `passed` using a ternary operator
 // It should be true if score >= 70, otherwise false
-// 💰 Use the comparison as the condition
 
 const stock = 0
 
diff --git a/exercises/04.control-flow/06.problem.errors/index.ts b/exercises/04.control-flow/06.problem.errors/index.ts
@@ -11,7 +11,6 @@ let hadError = false
 // - If Number.isNaN(parsedValue), throw a new Error with message `Invalid number: ${rawInput}`
 // - If it succeeds, set resultMessage to `Parsed value: ${parsedValue}`
 // - If it throws, set hadError to true and resultMessage to `Error: ${message}`
-// 💰 In the catch, check `error instanceof Error` before using `error.message`
 
 // console.log(resultMessage)
 
diff --git a/exercises/05.functions/02.problem.parameters/README.mdx b/exercises/05.functions/02.problem.parameters/README.mdx
@@ -16,6 +16,6 @@ but keep the return types explicit too.
 
 💰 Use explicit parameter and return types in each function.
 
-💰 For cents-to-dollars, convert cents to a decimal and format to two decimals.
+💰 Think about how to convert cents to a dollar amount.
 
 📜 [TypeScript Handbook - More on Functions](https://www.typescriptlang.org/docs/handbook/2/functions.html)
diff --git a/exercises/05.functions/03.problem.type-inference/index.ts b/exercises/05.functions/03.problem.type-inference/index.ts
@@ -18,11 +18,9 @@ function divide(a: number, b: number) {
 }
 
 // 🐨 Fix the bug by throwing an error instead of returning a string:
-// 💰 Throw an Error instead of returning a string
 
 // 🐨 Create a function `isEven` that returns true if a number is even
 // Let TypeScript infer the return type
-// 💰 Use modulo to check if a number is even
 
 // ✅ Test
 console.log(multiply(4, 5)) // 20
diff --git a/exercises/05.functions/04.problem.arrow-functions/index.ts b/exercises/05.functions/04.problem.arrow-functions/index.ts
@@ -18,12 +18,12 @@ function calculateTotal(subtotal: number, taxRate: number): number {
 }
 
 // 🐨 Create an arrow function `isEven` that returns true if a number is even
-// 💰 Use an arrow function with an implicit return
+// 💰 Short functions can be written more concisely
 
 // 🐨 Create a function `applyToNumber` that:
 // - Takes a number and a transform function
 // - Returns the transformed number
-// 💰 This function accepts a callback that transforms a number
+// 💰 Functions can accept other functions as parameters
 
 // 🐨 Create arrow functions:
 // - `triple` that multiplies a number by 3
diff --git a/exercises/05.functions/05.problem.jsdoc/index.ts b/exercises/05.functions/05.problem.jsdoc/index.ts
@@ -6,7 +6,7 @@
 // - @param tag documenting the `a` parameter
 // - @param tag documenting the `b` parameter
 // - @returns tag documenting what the function returns
-// 💰 JSDoc uses a block comment that starts with /**
+// 💰 Documentation comments have a special format
 function add(a: number, b: number): number {
 	return a + b
 }
@@ -16,7 +16,7 @@ function add(a: number, b: number): number {
 // - @param tag for the `name` parameter
 // - @returns tag
 // - @example tag showing how to use the function
-// 💰 Include an @example block that shows how to call the function
+// 💰 Examples help explain how to use the function
 function greet(name: string): string {
 	return `Hello, ${name}!`
 }
@@ -40,7 +40,7 @@ function calculateCompoundInterest(
 // - Takes a value, min, and max
 // - Returns the value constrained between min and max
 // - Has a complete JSDoc comment with description, @param, @returns, and @example
-// 💰 Use Math.min/Math.max to keep the value within range
+// 💰 Keep the value constrained between min and max
 
 // 🐨 Export your functions so we can verify your work
 // export { add, greet, calculateCompoundInterest, clamp }
diff --git a/exercises/06.void-and-never/01.problem.void-functions/index.ts b/exercises/06.void-and-never/01.problem.void-functions/index.ts
@@ -2,12 +2,12 @@
 // Functions that perform side effects return void
 
 // 🐨 Create `logInfo` that takes a message and logs it with "[INFO]" prefix
-// 💰 Return type should be void
+// 💰 Functions that don't return values have a special type
 
 // 🐨 Create `logError` that takes a message and logs it with "[ERROR]" prefix
 
 // 🐨 Create `logWithTimestamp` that takes a message and logs it with timestamp
-// 💰 Use an ISO timestamp from Date in the log output
+// 💰 Include the current time in the log
 
 // ✅ Test your functions
 // logInfo('Application started')
diff --git a/exercises/06.void-and-never/02.problem.never-type/index.ts b/exercises/06.void-and-never/02.problem.never-type/index.ts
@@ -3,19 +3,16 @@
 
 // 🐨 Create `throwError` that takes a message and throws
 // It should return `never` because it always throws
-// 💰 A never-returning function should always throw
 
 // 🐨 Create `parseNumber` that:
 // - Takes a string
 // - Converts it to a number with Number(...)
 // - Throws if the result is NaN
-// 💰 Return a number or throw when parsing fails
 
 // 🐨 Create `ensurePositive` that:
 // - Takes a number
 // - Throws if the number is negative
 // - Returns the number if it's valid
-// 💰 Return the number or throw if it is negative
 
 // ✅ Test
 // console.log(parseNumber('42'))
diff --git a/extra/README.mdx b/extra/README.mdx
@@ -1,6 +1,6 @@
-# Examples
+# Extras
 
-👨‍💼 These examples are here to help you _practice_ what you have already learned
+👨‍💼 These extras are here to help you _practice_ what you have already learned
 in the workshop. They are small, practical projects that keep the focus on the
 foundational skills: values, variables, functions, control flow, loops, and
 basic types.
@@ -15,5 +15,5 @@ areas with 🐨 instructions. Those are the parts that line up with what you've
 learned so far.
 
 🧠 **Spaced repetition** helps you remember what you learn by revisiting it over
-time. Practical examples like these give you lots of reps and quick wins, which
+time. Practical extras like these give you lots of reps and quick wins, which
 makes the concepts stick and builds momentum.
