Are there any best practices for writing PHP documentation to improve code readability and maintainability?

When writing PHP documentation to improve code readability and maintainability, it is essential to follow these best practices: 1. Use clear and descriptive comments to explain the purpose of functions, classes, and variables. 2. Document the input parameters, return values, and any potential side effects of functions. 3. Use consistent formatting and naming conventions to make the code easier to read and understand.

/**
 * This function calculates the sum of two numbers.
 *
 * @param int $num1 The first number to be added.
 * @param int $num2 The second number to be added.
 * @return int The sum of the two numbers.
 */
function calculateSum($num1, $num2) {
    return $num1 + $num2;
}