[wp-trac] [WordPress Trac] #58858: Docs: Wrap broken inline `@see` tags with curly braces.

WordPress Trac noreply at wordpress.org
Tue Oct 24 21:17:05 UTC 2023


#58858: Docs: Wrap broken inline `@see` tags with curly braces.
------------------------------+-----------------------
 Reporter:  costdev           |       Owner:  audrasjb
     Type:  defect (bug)      |      Status:  closed
 Priority:  normal            |   Milestone:  6.4
Component:  General           |     Version:
 Severity:  normal            |  Resolution:  fixed
 Keywords:  has-patch commit  |     Focuses:  docs
------------------------------+-----------------------

Comment (by johnbillion):

 There's 43 instances of `See {@see <function>()}` in core, but ~250 for
 something like `See [a-zA-Z0-9:_]+\(\)` which matches `See <function>()`.

 Perhaps we should remove all instances of `See {@see <function>()}` and
 use `See <function>()` instead as it makes the sentence in the source code
 more readble.

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


More information about the wp-trac mailing list