Change "blog" references to "site" in inline docs for wp-includes/link-template.php

[ericlewis]

This is a breakout ticket from #35417.

The term "site" is preferred to the term "blog" at this point, so we can update the docs accordingly.

[ericlewis]

Some starter thoughts in this file:

We can remove the content in the parenthesis ​in the inline docs for get_edit_bookmark_link() and edit_bookmark_link(). I don't think we need to explain what a bookmark is further than just calling it a bookmark.

​Here we could change the parameter description to Site ID. Optional, defaults to the current site.

​This could change to use site.

[mrahmadawais]

Converts "blog" instances to "site" inside the inline docs.

[mrahmadawais]

Ignored Grunt File. Converts "blog" instances to "site" inside the inline docs.

[mrahmadawais]

@ericlewis Have a look at the second patch file.

[mrahmadawais]

Updates "Blog ID" to "Site ID"

[ericlewis]

Great work here @mrahmadawais! I removed the parenthesis for the edit_bookmark_link() docs as well.

[ericlewis]

In 36386:

Networks and sites: Replace "blog" usage with "site" in docs.

This effort focuses on src/wp-includes/link-template.php.

Multisite functions use the term "blog" to refer to what we now call a "site," e.g. get_current_blog_id(). These functions are here to stay because of our commitment to backwards compatibility. What we can do is set the documentation straight.

Props mrahmadawais.
Fixes #35589.