[wp-trac] [WordPress Trac] #65074: Rendering error of the wp_register_ability_category() doc page

[WordPress Trac]

#65074: Rendering error of the wp_register_ability_category() doc page
--------------------------------+------------------------------
 Reporter:  satollo             |       Owner:  (none)
     Type:  defect (bug)        |      Status:  new
 Priority:  normal              |   Milestone:  Awaiting Review
Component:  WordPress.org Site  |     Version:  6.9.4
 Severity:  normal              |  Resolution:
 Keywords:                      |     Focuses:
--------------------------------+------------------------------

Comment (by iamadisingh):

 The rendering issue on the page is being triggered by the `<string,
 mixed>` part of the `@param tag`.

 Because of how the DevHub theme parses "hash notation" (the `{` brackets),
 the extra characters in the type declaration are confusing the formatter.
 It’s essentially a false positive where the theme sees the bracket but
 loses track of the variable name, resulting in the broken "mixed>" text we
 see on the site.

 Here: https://github.com/WordPress/wporg-developer/blob/trunk/source/wp-
 content/themes/wporg-developer-2023/inc/formatting.php#L625

 Same issue exists in `wp_register_ability` page:
 https://developer.wordpress.org/reference/functions/wp_register_ability/#parameters

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/65074#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform