docs: include versioning details and migration guides in the readme

[zimeg]

Summary

This PR adds a migration guide to the README and a "table of contents" to find fast links between section headers 👾 ✨

Following #398!

Preview

🔗 https://.com/slackapi/slack--action/tree/docs-migration-guide

Requirements

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.85%. Comparing base (f841ea5) to head (aecc23f).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #410   +/-   ##
=======================================
  Coverage   99.85%   99.85%           
=======================================
  Files           7        7           
  Lines         702      702           
=======================================
  Hits          701      701           
  Misses          1        1           

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

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[WilliamBergamin]

Nice 🚀 great job!!

[zimeg]

@WilliamBergamin Thanks a ton! But all credit to @thejeff77 for suggesting that this info be included in the README.md 👾

I'll go ahead with a merge now, but I'm so open to revisiting how or even where this information is organized later 📚 ✨

[thejeff77]

Thanks folks!

I have some additional tidbits to share, unfortunately with a lot of the inputs moving to the payload, actionlint is much less helpful in verifying if the action is still valid after migration. Requires a lot of trial and error.

It would be pretty cool if chatGPT or Copilot could be trained up on migrations to make this a bit more automated. I'm sure it will get there at some point anyway.

Hints on checking validity locally without having to commit, push, run would be welcome! (If they exist)