Parameter $linkdata missing array sub-parameters in DocBlock for wp_insert_link()

[stevenlinx]

Codex:
​https://codex.wordpress.org/Function_Reference/wp_insert_link

DevHub:
​https://developer.wordpress.org/reference/functions/wp_insert_link/

[peterwilsoncc]

@stevenlinx

Thanks for the patch, to meet the WordPress documentation standards it will need a few adjustments:

• Mostly white space in the @type, the variable names should align on $ and the first character of the descriptions should align too. For alignment, use spaces rather than tabs.
• Each type should be the PHP variable rather than the database type: varchar, datetime and text become string.
• Optional items will need to be indicated too.

You can read more about the ​documentation standards in the handbook.

I've labelled this needs-refresh but don't worry if you haven't got time. I've also reduced the priority as the link/blogroll feature has been deprecated for a while so this is less urgent than other issues.

[stevenlinx]

@peterwilsoncc

Thank you for the feedback.

I've made the adjustments in a new patch.

[SergeyBiryukov]

In 49487:

Docs: Document the $linkdata parameter of wp_insert_link() using hash notation.

Props stevenlinx, peterwilsoncc.
Fixes #50853.