Documentation that writes itself

/**
 * @name calculateTotal
 * @description Calculates the total price including tax and discounts
 * @param {number} price - The base price of the item
 * @param {number} quantity - The number of items
 * @param {number} taxRate - The tax rate as a decimal
 * @param {number} discount - The discount amount
 * @returns {number} - The total price
 */
function calculateTotal(price, quantity, taxRate, discount) {
  // Calculate subtotal
  const subtotal = price * quantity;
  // Apply discount
  const discountedPrice = subtotal - discount;
  // Add tax
  const total = discountedPrice * (1 + taxRate);
  return total;
}