Document per-resource poll interval and reconcile-request annotations

[yordis]

• Crossplane now supports two new annotations (crossplane.io/poll-interval and crossplane.io/reconcile-requested-at) that give operators fine-grained control over reconciliation behavior on a per-resource basis, introduced in Add per-resource poll interval and reconcile-now annotations crossplane#7239
• Without per-resource control, operators had to choose a single global poll interval that was either too aggressive for stable resources or too slow for dynamic ones
• The reconcile-request annotation follows the Flux CD pattern, providing a way to trigger immediate re-sync without modifying a resource's spec

Fixes #1082

[netlify]

✅ Deploy Preview for crossplane ready!

Name	Link
🔨 Latest commit	6eb7b8a
🔍 Latest deploy log	https://app.netlify.com/projects/crossplane/deploys/6a0c02c66f70e70007b1f02b
😎 Deploy Preview	https://deploy-preview-1083--crossplane.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 94 (🔴 down 2 from production) Accessibility: 90 (🔴 down 2 from production) Best Practices: 92 (no change from production) SEO: 100 (no change from production) PWA: 70 (no change from production) View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[adamwg]

lgtm once the line numbers are corrected. Thanks for the writeup!

[haarchri]

@yordis thanks for the PR can you check Vale issues?
https://github.com/crossplane/docs/actions/runs/24734156625/job/72368026690?pr=1083
after that we can merge it in for the coming v2.3 release - thanks man

[jbw976]

out of curiousity, for this to work on MRs, is it correct that the provider will need to have updated their crossplane-runtime dependency to v2.3.0? anything else that is required on the provider side after that, or will it work automatically after bumping crossplane-runtime?

is it worth adding a note in this section on this so users can understand this requirement?

[joraff]

Good point, I'll second this question. It's called out in the rc.1 release notes, but if someone upgrades without catching this, or starts using crossplane before the providers update and release new versions (which could be a long tail, hopefully not), it could cause some confusion. I think this will be a popular feature.

I don't recall seeing callouts in the crossplane docs on which release introduced a specific feature, as some other project docs do. If this was added, it could provide the opportunity to note this additional requirement. Bonus points for figuring out how to clearly and concisely communicate how to tell when a provider supports it.