Issue #3355603 by roshni27, joachim, Ranjit1032002, quietone: Docs for...

Issue #3355603 by roshni27, joachim, Ranjit1032002, quietone: Docs for ImageFieldCreationTrait and FileFieldCreationTrait are misleading

core/modules/file/tests/src/Functional/FileFieldCreationTrait.php

@@ -14,7 +14,8 @@ trait FileFieldCreationTrait {
    * Creates a new file field.
    *
    * @param string $name
-   *   The name of the new field (all lowercase), exclude the "field_" prefix.
+   *   The name of the new field (all lowercase). The Field UI 'field_' prefix
+   *   is not added to the field name.
    * @param string $entity_type
    *   The entity type.
    * @param string $bundle
@@ -47,7 +48,8 @@ public function createFileField($name, $entity_type, $bundle, $storage_settings
    * Attaches a file field to an entity.
    *
    * @param string $name
-   *   The name of the new field (all lowercase), exclude the "field_" prefix.
+   *   The name of the new field (all lowercase). The Field UI 'field_' prefix
+   *   is not added to the field name.
    * @param string $entity_type
    *   The entity type this field will be added to.
    * @param string $bundle

core/modules/image/tests/src/Kernel/ImageFieldCreationTrait.php

@@ -14,7 +14,8 @@ trait ImageFieldCreationTrait {
    * Create a new image field.
    *
    * @param string $name
-   *   The name of the new field (all lowercase), exclude the "field_" prefix.
+   *   The name of the new field (all lowercase). The Field UI 'field_' prefix
+   *   is not added to the field name.
    * @param string $type_name
    *   The node type that this field will be added to.
    * @param array $storage_settings