Updated Drupal to 8.6. This goes with the following updates because it's possible...
[yaffs-website] / web / core / lib / Drupal / Core / TypedData / TranslatableInterface.php
index 76a9f9556af56667353649c958ccaeec830683be..4dabef12f0e93c83b0ba6e4fb588e3f0ee018440 100644 (file)
@@ -4,6 +4,21 @@ namespace Drupal\Core\TypedData;
 
 /**
  * Interface for translatable data.
+ *
+ * Classes implementing this interface do not necessarily support translations.
+ *
+ * To detect whether an entity type supports translation, call
+ * EntityTypeInterface::isTranslatable().
+ *
+ * Many entity interfaces are composed of numerous other interfaces such as this
+ * one, which allow implementations to pick and choose which features to support
+ * through stub implementations of various interface methods. This means that
+ * even if an entity class implements TranslatableInterface, it might only have
+ * a stub implementation and not a functional one.
+ *
+ * @see \Drupal\Core\Entity\EntityTypeInterface::isTranslatable()
+ * @see https://www.drupal.org/docs/8/api/entity-api/structure-of-an-entity-annotation
+ * @see https://www.drupal.org/docs/8/api/entity-api/entity-translation-api
  */
 interface TranslatableInterface {