doc: add plugins migration guide and notices for cordova-ios 8.0.0

[GitToTheHub]

When I need the migration guide, I always went to https://cordova.apache.org/blog/ and searched for ios 8 to find the link. To find it easier I added a section to the readme.

Platforms affected

Motivation and Context

Description

Testing

Checklist

• I've run the tests to see all new and existing tests pass
• I added automated test coverage as appropriate for this change
• Commit is prefixed with (platform) if this change only applies to one platform (e.g. (android))
• If this Pull Request resolves an issue, I linked to the issue in the text above (and used the correct keyword to close issues using keywords)
• I've updated the documentation if necessary

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.17%. Comparing base (3680775) to head (0b1f12d).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1600   +/-   ##
=======================================
  Coverage   80.17%   80.17%           
=======================================
  Files          18       18           
  Lines        5251     5251           
=======================================
  Hits         4210     4210           
  Misses       1041     1041           

☔ 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.

[dpogue]

I don't really think this belongs in the repository readme. What we need to do is write a proper "How to migrate your app to cordova-ios 8.0.0" guide in the docs, and link to the info for plugin authors there.

[GitToTheHub]

What does a guide for "How to migrate your app to cordova-ios 8.0.0" would include? When I updated my App to cordova-ios 8, the only problems were the plugins. Apart from the plugins, what else could have to be migrated?

[dpogue]

• Clearly communicating the updated minimum SDK and tooling versions
• Explaining that you don't need the status bar plugin anymore and how to use viewport-fit and theme-color
• Explaining the new options for icons (dark mode, tinted mode, using a single 1024×1024 file)
• Explaining how to use Cloud Distribution certificates for automatic code signing
• etc.

[GitToTheHub]

Wow I didn't know. When I looked on the blog, I think everything you mentioned is mentioned in the blog article for cordova-ios 8: https://cordova.apache.org/announcements/2025/11/23/cordova-ios-8.0.0.html. With that a migration guide could be written.. When you write about writing a guide in the docs, do you mean cordova.apache.org? I know it exists some migration pages for cordova-ios but they are not linked there, or I couldn't find them.

[dpogue]

Stuff is mentioned on the blog, but there's no detail or examples to show app developers what to do in their apps.

Having clear platform upgrade guides as part of the docs is something we definitely need. Right now we have a very out-of-date page that is buried and impossible to find: https://cordova.apache.org/docs/en/latest/guide/platforms/ios/upgrade.html

[GitToTheHub]

Ok does anyone plan to write this guide? I'm not so familiar with the cordova-ios 8 changes and this is something we can do regarding HeroDevs.

[GitToTheHub]

I wrote a migration guide on apache/cordova-docs#1487

[GitToTheHub]

Superseded by apache/cordova-docs#1487