Do Not Send Me Your AI Code to Review

# ==============================================================================
# SCRIPT NAME: add_numbers.py
# PURPOSE: Calculate the sum of two numerical values.
# AUTHOR: An overly thorough, hyper-documented AI collaborator
# PARADIGM: Imperative / Procedural
# COMPLEXITY:
#   - Time Complexity: O(1) - Constant time operation
#   - Space Complexity: O(1) - Constant memory allocation
# ==============================================================================

# We begin by defining our function using the 'def' keyword.
# 'def' is short for 'define'. It tells the Python interpreter that a reusable
# block of executable statements is about to be declared.
def calculate_sum(
    # --------------------------------------------------------------------------
    # PARAMETER 1: number_one
    # TYPE: int or float
    # ROLE: The augend (the primary quantity to which another is added)
    # --------------------------------------------------------------------------
    number_one,  # Represents the first input value

    # --------------------------------------------------------------------------
    # PARAMETER 2: number_two
    # TYPE: int or float
    # ROLE: The addend (the secondary quantity added to the augend)
    # --------------------------------------------------------------------------
    number_two   # Represents the second input value
): # The colon ':' signifies the end of the signature and the start of the indented block.

    # --------------------------------------------------------------------------
    # EXECUTION STEP 1: ARITHMETIC OPERATION
    # Here, the binary addition operator '+' is used.
    # Python evaluates the expression on the right side of '=' first.
    # It fetches 'number_one' and 'number_two' from local scope memory,
    # computes their sum, and then binds that value to the variable 'total'.
    # --------------------------------------------------------------------------
    total = number_one + number_two  # Addition happens here!

    # --------------------------------------------------------------------------
    # EXECUTION STEP 2: RETURN RESULT
    # The 'return' keyword terminates function execution immediately.
    # It passes the value stored in 'total' back to whichever line of code
    # originally called this function.
    # --------------------------------------------------------------------------
    return total  # Handing the calculated value back to the caller.


# ==============================================================================
# USAGE DEMONSTRATION
# The code below demonstrates how to invoke (call) the function defined above.
# ==============================================================================

# Declare a variable 'first_value' and assign it an integer literal '10'.
first_value = 10  # 10 is an integer object in memory

# Declare a variable 'second_value' and assign it an integer literal '20'.
second_value = 20  # 20 is another integer object in memory

# Call 'calculate_sum', passing 'first_value' (10) and 'second_value' (20) as arguments.
# Store the returned result in a brand-new variable called 'final_result'.
final_result = calculate_sum(first_value, second_value)  # Function invocation

# Pass 'final_result' into Python's built-in print() function.
# This writes the string representation of 30 to stdout (the console).
print(final_result)  # Output: 30