diff --git a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php
index ac21cfe..bc6f606 100644
--- a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php
+++ b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php
@@ -221,11 +221,13 @@ class Field extends ConfigEntityBase implements FieldInterface {
    *     a 'field_name' property can be accepted in place of 'id'.
    *   - type: required.
    *
-   * In most cases, it's constructed via entity_create('field_entity', $values)),
-   * where $values is the same parameter for this constructor.
+   * In most cases, Field entities are created via
+   * entity_create('field_entity', $values)), where $values is the same
+   * parameter as in this constructor.
    *
-   * See: @link entity_create() @endlink.
-   * @ingroup field Field API data structures
+   * @see entity_create()
+   *
+   * @ingroup field_types
    */
   public function __construct(array $values, $entity_type = 'field_entity') {
     // Check required properties.
diff --git a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php
index aff566d..8edcd64 100644
--- a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php
+++ b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php
@@ -216,10 +216,13 @@ class FieldInstance extends ConfigEntityBase implements FieldInstanceInterface {
    *   - entity_type: required.
    *   - bundle: required.
    *
-   * In most cases, it's constructed via entity_create('field_instance', $values)),
-   * where $values is the same parameter for this constructor.
+   * In most cases, Field instance entities are created via
+   * entity_create('field_instance', $values)), where $values is the same
+   * parameter as in this constructor.
    *
-   * See: @link entity_create() @endlink.
+   * @see entity_create()
+   *
+   * @ingroup field_types
    */
   public function __construct(array $values, $entity_type = 'field_instance') {
     // Accept incoming 'field_name' instead of 'field_uuid', for easier DX on