diff --git a/src/wp-includes/widgets.php b/src/wp-includes/widgets.php
index b30452e1fd..db06222a51 100644
--- a/src/wp-includes/widgets.php
+++ b/src/wp-includes/widgets.php
@@ -234,16 +234,17 @@ function register_sidebars( $number = 1, $args = array() ) {
  *                                  Default empty string.
  *     @type string $class          Extra CSS class to assign to the sidebar in the Widgets interface.
  *                                  Default empty.
- *     @type string $before_widget  HTML content to prepend to each widget's HTML output when
- *                                  assigned to this sidebar. Default is an opening list item element.
- *     @type string $after_widget   HTML content to append to each widget's HTML output when
- *                                  assigned to this sidebar. Default is a closing list item element.
+ *     @type string $before_widget  HTML content to prepend to each widget's HTML output when assigned
+ *                                  to this sidebar. Receives the widget's ID attribute as `%1$s`
+ *                                  and class name as `%2$s`. Default is an opening list item element.
+ *     @type string $after_widget   HTML content to append to each widget's HTML output when assigned
+ *                                  to this sidebar. Default is a closing list item element.
  *     @type string $before_title   HTML content to prepend to the sidebar title when displayed.
  *                                  Default is an opening h2 element.
  *     @type string $after_title    HTML content to append to the sidebar title when displayed.
  *                                  Default is a closing h2 element.
  *     @type string $before_sidebar HTML content to prepend to the sidebar when displayed.
- *                                  Receives the '$id' argument as %1$s and '$class' as %2$s.
+ *                                  Receives the `$id` argument as `%1$s` and `$class` as `%2$s`.
  *                                  Outputs after the {@see 'dynamic_sidebar_before'} action.
  *                                  Default empty string.
  *     @type string $after_sidebar  HTML content to append to the sidebar when displayed.