/**
* 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 {