diff --git a/core/lib/Drupal/Core/Language/language.api.php b/core/lib/Drupal/Core/Language/language.api.php
index f0dc2f7..f66dd5a 100644
--- a/core/lib/Drupal/Core/Language/language.api.php
+++ b/core/lib/Drupal/Core/Language/language.api.php
@@ -29,9 +29,10 @@
  * - Any time UI text is displayed using PHP code, it should be passed through
  *   either the global t() function or a t() method on the class. If it
  *   involves plurals, it should be passed through either the global
- *   formatPlural() function or a formatPlural() method on the class. Use
- *   \Drupal\Core\StringTranslation\StringTranslationTrait to get these methods
- *   into a class.
+ *   \Drupal\Core\StringTranslation\PluralTranslatableMarkup::createFromTranslatedString(),
+ *   or a formatPlural() method on the class.
+ *   Use \Drupal\Core\StringTranslation\StringTranslationTrait to get these
+ *   methods into a class.
  * - Dates displayed in the UI should be passed through the 'date' service
  *   class's format() method. Again see the Services topic; the method to
  *   call is \Drupal\Core\Datetime\Date::format().