التعليقات والتوثيق

// ❌ Before improvement:

// Function to calculate price
function calc(p, q) {
  // Price multiplied by quantity
  return p * q;
}

// Check user eligibility
function check(u) {
  // If user age is greater than 18
  if (u.age > 18) {
    return true;
  }
  return false;
}

// ✅ After improvement:

/**
 * Calculate order total price
 * @param {number} unitPrice - Unit price
 * @param {number} quantity - Required quantity
 * @returns {number} Total before tax
 */
function calculateOrderTotal(unitPrice, quantity) {
  return unitPrice * quantity;
}

/**
 * Check customer eligibility for purchase
 * Customer must be 18 years or older per regulations
 * @param {Object} customer - Customer data
 * @param {number} customer.age - Customer age in years
 * @returns {boolean} true if eligible
 */
function isCustomerEligible(customer) {
  const minimumAge = 18;
  return customer.age >= minimumAge;
}