HTML API: Fix ordering issue in docblock that's breaking Developer Resources

[dmsnell]

In this patch we're re-ordering the @see tag in the docblock comment for WP_HTML_Tag_Processor::get_attribute_names_with_prefix. Previously the rendering in Developer Resources was broken, whereby it merged the link in the @see tag with the example code.

​https://developer.wordpress.org/reference/classes/wp_html_tag_processor/get_attribute_names_with_prefix/

Now, in this patch, the @see tag has been moved below the code example so that the example is properly extracted.

Additionally the example code for WP_HTML_Tag_Processor::get_tag has been updated to show lowercase tag names in the input HTML so that it doesn't convey the wrong impression that the uppercase output from get_tag() depends on the case of the input HTML.

Trac: #58254-ticket

In this patch we're re-ordering the @see tag in the docblock comment for WP_HTML_Tag_Processor::get_attribute_names_with_prefix. Previously the rendering in Developer Resources was broken, whereby it merged the link in the @see tag with the example code.

​https://developer.wordpress.org/reference/classes/wp_html_tag_processor/get_attribute_names_with_prefix/

Now, in this patch, the @see tag has been moved below the code example so that the example is properly extracted.

Additionally the example code for WP_HTML_Tag_Processor::get_tag has been updated to show lowercase tag names in the input HTML so that it doesn't convey the wrong impression that the uppercase output from get_tag() depends on the case of the input HTML.

## Screenshot

After this patch the example code should appear in its own block as with all the other methods in the class.

[dmsnell]

cc: @zieladam @bernhard-reiter @johnbillion

thanks @johnbillion for reviewing these developer docs! I found this because of the other issues you fixed

[SergeyBiryukov]

Thanks for the ticket!

I think this can be addressed in 6.2.1 along with #58028.

Thanks for putting this PR together!
Indeed, this change is welcome to ship with 58028 in milestone 6.2.1 👍

[SergeyBiryukov]

In 55724:

Docs: Correct the placement of @see tags in WP_HTML_Tag_Processor class.

This moves a reference link in ::get_attribute_names_with_prefix() below the code example, so that it is correctly displayed in the Developer Resources.

Includes updating some other @see tags for consistency as per the documentation standards.

Additionally, the example code for WP_HTML_Tag_Processor::get_tag() is updated to show lowercase tag names in the input HTML, so that it does not convey the wrong impression that the uppercase output from ::get_tag() depends on the case of the input HTML.

Follow-up to [55203].

Props dmsnell, johnbillion, audrasjb, SergeyBiryukov.
Fixes #58254.

[SergeyBiryukov]

Reopening for 6.2.1.

Thanks for the PR! Merged in r55724.

[dmsnell]

Thanks!

[SergeyBiryukov]

In 55728:

Docs: Correct the placement of @see tags in WP_HTML_Tag_Processor class.

This moves a reference link in ::get_attribute_names_with_prefix() below the code example, so that it is correctly displayed in the Developer Resources.

Includes updating some other @see tags for consistency as per the documentation standards.

Additionally, the example code for WP_HTML_Tag_Processor::get_tag() is updated to show lowercase tag names in the input HTML, so that it does not convey the wrong impression that the uppercase output from ::get_tag() depends on the case of the input HTML.

Follow-up to [55203].

Props dmsnell, johnbillion, audrasjb, SergeyBiryukov.
Merges [55724] to the 6.2 branch.
Fixes #58254.