Index: src/wp-includes/taxonomy.php
===================================================================
--- src/wp-includes/taxonomy.php	(revision 55014)
+++ src/wp-includes/taxonomy.php	(working copy)
@@ -1229,16 +1229,17 @@
  * The {@see 'get_terms_orderby'} filter passes the `ORDER BY` clause for the query
  * along with the $args array.
  *
- * Prior to 4.5.0, the first parameter of `get_terms()` was a taxonomy or list of taxonomies:
+ * Since 4.5.0, taxonomies should be passed via the 'taxonomy' argument in the `$args` array:
  *
- *     $terms = get_terms( 'post_tag', array(
+ *     $terms = get_terms( array(
+ *         'taxonomy' => 'post_tag',
  *         'hide_empty' => false,
  *     ) );
  *
- * Since 4.5.0, taxonomies should be passed via the 'taxonomy' argument in the `$args` array:
+ * Prior to 4.5.0, the first parameter of `get_terms()` was a taxonomy or list of taxonomies.
+ * Please do not use this deprecated way of using `get_terms()` anymore.
  *
- *     $terms = get_terms( array(
- *         'taxonomy' => 'post_tag',
+ *     $terms = get_terms( 'post_tag', array(
  *         'hide_empty' => false,
  *     ) );
  *