Are there any best practices for structuring PHP code for effective documentation with Doxygen?

When structuring PHP code for effective documentation with Doxygen, it is important to follow certain best practices to ensure clarity and consistency in the generated documentation. One key practice is to use meaningful and descriptive comments for each function, class, and variable to provide context and explanation for future developers. Additionally, organizing code into logical sections with proper indentation and spacing can help improve readability and understanding.

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