Improve inline docs for the_author_meta

[grapplerulrich]

In the inline documentation for the_author_meta() there is no reference to the fields that are included in WordPress core. This also affects get_the_author_meta too. There is a complete list in the codex ​https://codex.wordpress.org/Function_Reference/the_author_meta

[choongsavvii]

First time contributor here, at WordCamp NL. At first I thought this was not a good idea, as we would be duplicating the documentation, but our core team guide at the venue (John) explained the codex would move to developer.wordpress.org, where the documentation would be generated from the doc comments. So, this seemed like a simple one to start off with.

Also, it seemed logical to remove the 'needs-patch' tag, so I did. Hope that's OK.

[grapplerulrich]

The reference in seems to point to it's self. I think you meant See get_the_author_meta(). I would have documented the list of parameters under @param string $field instead of higher up. If John mentioned to do it differently then that is best.

The reason to document is so that it can be processed and be added to ​https://developer.wordpress.org/reference/functions/get_the_author_meta/

[choongsavvii]

Oops, sloppy sloppy. Thanks, I corrected this in 38258.2.patch.

@johnbillion indeed mentioned to do it in the description section. It does seem neater to do it in the description imo. Incidentally, further down that same file there is a doccomment for wp_list_authors() which lists fields at the @param. It's more difficult to read, sort alphabetically, or make changes in - plus, any changes will be harder to spot in diffs.

[DrewAPicture]

@choongsavvii Thanks for the patch. I'm going to make some minor formatting changes on commit, but this is ready to go in!

[DrewAPicture]

In 40952:

Docs: List out accepted values for the $field parameter in get_the_author_meta().

Props choongsavvii.
Fixes #38258.