file.api.php documentation is incorrect

There are usages in core where upload_validators are used with the type file. For example in Drupal\system\Form\ThemeSettingsForm, see: https://git.drupalcode.org/project/drupal/-/blob/11.x/core/modules/syste...

      $form['logo']['settings']['logo_upload'] = [
        '#type' => 'file',
        '#title' => $this->t('Upload logo image'),
        '#description' => $this->t("If you don't have direct file access to the server, use this field to upload your logo."),
        '#upload_validators' => [
          'FileIsImage' => [],
        ],
      ];

Based on this I think it is possible to use upload_validators on type file as well.

I believe we should close this issue.

There are few more usages of upload validators with the file elmement.
like
Drupal\locale\Form\ImportForm.php

$form['file'] = [
      '#type' => 'file',
      '#title' => $this->t('Translation file'),
      '#description' => [
        '#theme' => 'file_upload_help',
        '#description' => $this->t('A Gettext Portable Object file.'),
        '#upload_validators' => $validators,
      ],
      '#size' => 50,
      '#upload_validators' => $validators,
      '#upload_location' => 'translations://',
      '#attributes' => ['class' => ['file-import-input']],
    ];

Feel free to re-open if you feel we still need to alter documentation to mention both the #types of fields.