docs: add consumer_version

[JP-Ellis]

📝 Summary

Consumer version was recently added (in 3.2), and wasn't added to the docs properly.

🚨 Breaking Changes

🔥 Motivation

Improve visibility of the consumer_version method.

🔨 Test Plan

🔗 Related issues/PRs

• Function introduced in feat: add consumer_version method #1315

[Copilot]

Pull request overview

This PR adds documentation for the consumer_version method that was introduced in version 3.2 but not properly documented. The changes update the provider documentation and migration guide to demonstrate the new selector method.

Key changes:

• Added comprehensive documentation for consumer_version method with usage examples
• Updated code examples to replace deprecated consumer_tags with consumer_version
• Removed deprecated tags parameter from publish options example

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
docs/provider.md	Added new section documenting consumer_version method with common use cases and updated examples to use the new method instead of deprecated consumer_tags
MIGRATION.md	Updated migration example to use consumer_version instead of consumer_tags and added explanation of the new method

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 51%. Comparing base (c612a67) to head (6c111af).
⚠️ Report is 2 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@         Coverage Diff          @@
##           main   #1364   +/-   ##
====================================
  Coverage    51%     51%           
====================================
  Files        31      31           
  Lines      3729    3729           
====================================
  Hits       1938    1938           
  Misses     1791    1791           

Flag	Coverage Δ
tests	51% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.