diff --git a/core/modules/system/theme.api.php b/core/modules/system/theme.api.php
index 6ce8630..6b76846 100644
--- a/core/modules/system/theme.api.php
+++ b/core/modules/system/theme.api.php
@@ -29,9 +29,8 @@
  * return $item_list;
  * @endcode
  *
- * Note that calling the _theme() function directly is highly discouraged.
- * Building and returning a renderable array in a page build process is
- * preferred. If necessary, the array may be rendered to a string in-place
+ * Do not call _theme() directly; instead, build and return a renderable array.
+ * If necessary, the array may be rendered to a string in-place
  * by calling drupal_render().
  *
  * @code