Comments

# This is a comment
let x = 10  # Inline comment

// This is also a comment
let y = 20  // Inline comment

/*
  This is a multi-line comment.
  It can span multiple lines.
  Useful for longer explanations.
*/

let z = 30

# Calculates the sum of two numbers
# 
# Args:
#   a: First number
#   b: Second number
# 
# Returns:
#   Sum of a and b
fn add(a: i32, b: i32) -> i32 {
  return a + b
}

# Math Module
# 
# Provides basic arithmetic operations:
# - Addition
# - Subtraction
# - Multiplication
# - Division

module math

# Calculate factorial using recursion
# Base case: n <= 1 returns 1
fn factorial(n: i32) -> i32 {
  if n <= 1 {
    return 1  # Base case
  }
  return n * factorial(n - 1)  # Recursive case
}

# Bad: Obvious comment
let x = 10  # Set x to 10

# Good: Explains why
let timeout = 30  # 30 seconds - enough for slow networks

# Temporarily disabled for debugging
# let result = expensive_calculation()

# Use this instead
let result = quick_calculation()

# TODO: Add error handling
# TODO: Optimize this function
# FIXME: Handle edge case when x is negative
# NOTE: This works but could be improved

# Validates user input and returns sanitized value
# 
# This function:
# - Trims whitespace
# - Removes special characters
# - Converts to lowercase
# 
# Args:
#   input: Raw user input string
# 
# Returns:
#   Sanitized string ready for processing
fn sanitize(input: str) -> str {
  # Implementation coming soon
  return input
}