Alberto Paderno
--- a/modules/ai_image_bulk_alt_text/src/Form/AltTextFixer.php
+++ b/modules/ai_image_bulk_alt_text/src/Form/AltTextFixer.php
 use Drupal\Core\Form\FormStateInterface;
 use Symfony\Component\DependencyInjection\ContainerInterface;

+/**
+ * Provides a form to bulk generate alt text for images using AI.
+ *
+ * This form identifies image fields across various entity types with missing
+ * alt text and allows users to bulk generate or manually add alt text.
--- a/src/Controller/GenerateAltText.php
+++ b/src/Controller/GenerateAltText.php
   *
-   * @param \Drupal\file\Entity\File $file
-   *   File entity.
+   * It generates an alt text for an image file using a configured AI provider.
+   *
+   * @param \Drupal\file\Entity\File|null $file
+   *   The file entity representing the image.
+   * @param string $lang_code
+   *   The language code to be used for generating the alt text (default: 'en').
   *
   * @return \Symfony\Component\HttpFoundation\JsonResponse
-   *   JSON response.
+   *   A JSON response containing the generated alt text or an error message.
   */
-  public function generate(File $file = NULL, $lang_code = 'en') {
+  public function generate(?File $file = NULL, $lang_code = 'en') {
--- a/src/ProviderHelper.php
+++ b/src/ProviderHelper.php
 use Drupal\ai\AiProviderPluginManager;
 use Drupal\Core\Config\ConfigFactoryInterface;

+/**
+ * Provides helper methods to manage AI providers for image alt text generation.
+ *
+ * This class encapsulates logic to retrieve and manage AI providers and models
+ * for the 'ai_image_alt_text' module. It interacts with the configuration
+ * system and AI provider plugin manager to determine the appropriate provider
+ * and model to use for generating alt text.