diff --git a/core/includes/theme.inc b/core/includes/theme.inc
index aa558b2..de111b1 100644
--- a/core/includes/theme.inc
+++ b/core/includes/theme.inc
@@ -406,10 +406,14 @@ function drupal_find_base_themes($themes, $key) {
  * @link themeable theme function or template @endlink, by checking the theme
  * registry.
  *
- * Avoid calling this function directly. It is preferable to replace direct
- * calls to the _theme() function with calls to drupal_render() by passing a
- * render array with a #theme key to drupal_render(), which in turn calls
- * _theme().
+ * Avoid calling this function directly as it raises several issues:
+ * - Circumvents caching.
+ * - Circumvents defaults of types defined in hook_element_info(), including
+ *   attached assets.
+ * - Circumvents the pre_render and post_render stages.
+ * - Circumvents JavaScript states information.
+ * The correct method is to pass a render array with a #theme key to
+ * drupal_render(), which in turn calls _theme().
  *
  * @section sec_theme_hooks Theme Hooks
  * Most commonly, the first argument to this function is the name of the theme