Docs: Replace @since x.y.z with actual version number

[oztaser]

The x.y.z version number was not replaced with the actual WordPress version in which this feature was introduced.

Introduced in r60364 to fix #43421

• wp-includes/class-wp-roles.php, line 168
• wp-includes/capabilities.php, line 1127

<?php
@since x.y.z Support was added for a numerically indexed array of strings for the capabilities array.

[solankisoftware]

Fix :: Docs: Replace @since x.y.z with actual version number

[solankisoftware]

Title:
Docs: Replace placeholder @since x.y.z with actual version numbers

Description:
Updated documentation comments by replacing all placeholder @since x.y.z tags with the correct released version numbers. This ensures consistency across the docs and improves clarity for users referencing version-specific features.

This PR replaces placeholder @since x.y.z tags with the accurate version number 6.9.0 in:

• wp-includes/class-wp-roles.php
• wp-includes/capabilities.php

These updates follow WordPress documentation standards and align with Core ticket #64366.

Trac ticket: https://core.trac.wordpress.org/ticket/64366

Fixes #64366.

[westonruter]

In 61354:

Docs: Update @since x.y.z with actual version number.

Follow-up to [60364].

Props solankisoftware, oztaser.
See #43421.
Fixes #64366.

[westonruter]

Re-opening for 6.9.1 backport.

[jorbin]

[61354] looks good to backport to the 6.9 branch

Trac Ticket: https://core.trac.wordpress.org/ticket/64366

This PR enhances the WordPress Site Health page cache test by introducing
a robust cache header detection mechanism. The previous method could
produce false positives or negatives depending on the caching system used.

Changes include:

• Added detect_cache_headers() method for strict, case-insensitive header matching
• Improved support for common cache headers (x-cache, x-cache-status, cf-cache-status, x-litespeed-cache, x-varnish, etc.)
• Updated get_test_page_cache() to use detect_cache_headers()
• Prevents false positives when unrelated text contains words like "HIT" or "MISS"

Testing:

1. Enable any caching layer (Varnish, NGINX fastcgi_cache, Cloudflare, LiteSpeed, host-level caching)
2. Go to Tools → Site Health → Status
3. Verify that page cache detection reflects the real server cache status

This PR is backward compatible and does not change existing Site Health UI behavior.

[solankisoftware]

The PR #10606 was created by mistake and is not related to this ticket.
Please ignore that PR. The correct PR for this ticket is #10605.

[westonruter]

Replying to solankisoftware:

The PR #10606 was created by mistake and is not related to this ticket.
Please ignore that PR. The correct PR for this ticket is #10605.

I think you're commenting on the wrong ticket. I think you're intending to comment on #64370

[peterwilsoncc]

In 61381:

Docs: Update @since x.y.z with actual version number.

Follow-up to [60364].

Reviewed by jorbin.
Merges [61354] to the 6.9 branch.

Props solankisoftware, oztaser, westonruter.
See #43421.
Fixes #64366.