diff --git a/core/lib/Drupal/Core/Render/theme.api.php b/core/lib/Drupal/Core/Render/theme.api.php
index 44fcdd0..0d7a2b3 100644
--- a/core/lib/Drupal/Core/Render/theme.api.php
+++ b/core/lib/Drupal/Core/Render/theme.api.php
@@ -1098,11 +1098,12 @@ function hook_page_bottom(array &$page_bottom) {
  *   instead of the array key being the base theme hook, the key is a theme
  *   suggestion name with the format 'base_hook_name__sub_hook_name'.
  *   For render elements, the key is the machine name of the render element.
- *   The array values are themselves arrays containing information about the
- *   theme hook and its implementation. Each information array must contain
- *   either a 'variables' element (for using a #theme element) or a
- *   'render element' element (for render elements), but not both.
- *   The following elements may be part of each information array:
+ *   The array values are themselves may either contain
+ *   \Drupal\Core\Theme\ThemeHook objects, or arrays containing information
+ *   about the theme hook and its implementation. Each information array must
+ *   contain either a 'variables' element (for using a #theme element) or a
+ *   'render element' element (for render elements), but not both. If not using
+ *   an object, the following elements may be part of each information array:
  *   - variables: Only used for #theme in render array: an array of variables,
  *     where the array keys are the names of the variables, and the array
  *     values are the default values if they are not given in the render array.
diff --git a/core/lib/Drupal/Core/Theme/ThemeHook.php b/core/lib/Drupal/Core/Theme/ThemeHook.php
index c9173c0..19048ee 100644
--- a/core/lib/Drupal/Core/Theme/ThemeHook.php
+++ b/core/lib/Drupal/Core/Theme/ThemeHook.php
@@ -5,12 +5,10 @@
 /**
  * Provides a value object for a theme hook.
  *
- * @internal
- *
  * @todo This class exists as an iterative improvement to the Theme API but is
- *   marked internal until finalized. See https://www.drupal.org/node/2869859
- *   for next steps. See https://www.drupal.org/node/2873117 for finalizing the
- *   removal of \ArrayAccess.
+ *   is not yet finalized. See https://www.drupal.org/node/2869859 for next
+ *   steps. See https://www.drupal.org/node/2873117 for finalizing the removal
+ *   of \ArrayAccess.
  */
 class ThemeHook implements \ArrayAccess {