What are the necessary improvements to be made in older PHP image generation scripts, such as adding comments, @param, and @return annotations for better readability and maintainability?

Older PHP image generation scripts can be difficult to understand and maintain without proper documentation. Adding comments, @param, and @return annotations can greatly improve the readability and maintainability of the code. Comments should explain the purpose of each section of code, @param should describe the input parameters of functions, and @return should specify the return value of functions.

/**
 * Generate an image with the given dimensions and text
 *
 * @param int $width The width of the image
 * @param int $height The height of the image
 * @param string $text The text to be displayed on the image
 * @return resource The generated image resource
 */
function generateImage($width, $height, $text) {
    // Code to generate the image
}