diff --git a/core/includes/bootstrap.inc b/core/includes/bootstrap.inc
index 41c6eb0..35653b9 100644
--- a/core/includes/bootstrap.inc
+++ b/core/includes/bootstrap.inc
@@ -305,7 +305,8 @@ function drupal_get_path($type, $name) {
  *     belongs to.
  *
  * @return
- *   The translated string.
+ *   A new Markup object that, when cast to a string, will result in the
+ *   translated string.
  *
  * @see \Drupal\Component\Utility\SafeMarkup::format()
  * @ingroup sanitization
diff --git a/core/lib/Drupal/Core/StringTranslation/TranslationInterface.php b/core/lib/Drupal/Core/StringTranslation/TranslationInterface.php
index 57ed36e..26d3e28 100644
--- a/core/lib/Drupal/Core/StringTranslation/TranslationInterface.php
+++ b/core/lib/Drupal/Core/StringTranslation/TranslationInterface.php
@@ -34,7 +34,8 @@
    *   - 'context': The context the source string belongs to.
    *
    * @return \Drupal\Core\StringTranslation\TranslatableMarkup
-   *   The translated string.
+   *   A new Markup object that, when cast to a string, will result in the
+   *   translated string.
    *
    * @see \Drupal\Component\Utility\SafeMarkup::format()
    */