From f67e645351c29f29fd8e6f71ec2fc80b47e5200d Mon Sep 17 00:00:00 2001 From: Markus Sanin Date: Mon, 8 Dec 2025 07:25:11 +0100 Subject: [PATCH] Add first part for migrate to 9.x --- docs/app/router.ts | 1 + .../public-pages/docs/migrate-8-0-to-9-0.ts | 3 + docs/app/templates/public-pages/docs.gts | 4 + .../public-pages/docs/migrate-7-0-to-8-0.gts | 4 +- .../public-pages/docs/migrate-8-0-to-9-0.gts | 89 +++++++++++++++++++ .../docs/migrate-8-0-to-9-0-test.ts | 13 +++ 6 files changed, 112 insertions(+), 2 deletions(-) create mode 100644 docs/app/routes/public-pages/docs/migrate-8-0-to-9-0.ts create mode 100644 docs/app/templates/public-pages/docs/migrate-8-0-to-9-0.gts create mode 100644 docs/tests/unit/routes/public-pages/docs/migrate-8-0-to-9-0-test.ts diff --git a/docs/app/router.ts b/docs/app/router.ts index 6f46f079..e31f0cba 100644 --- a/docs/app/router.ts +++ b/docs/app/router.ts @@ -33,6 +33,7 @@ Router.map(function () { // Other this.route('test-helpers'); this.route('api-reference'); + this.route('migrate-8-0-to-9-0'); }); this.route('cookbook', function () { diff --git a/docs/app/routes/public-pages/docs/migrate-8-0-to-9-0.ts b/docs/app/routes/public-pages/docs/migrate-8-0-to-9-0.ts new file mode 100644 index 00000000..fe2d4d25 --- /dev/null +++ b/docs/app/routes/public-pages/docs/migrate-8-0-to-9-0.ts @@ -0,0 +1,3 @@ +import Route from '@ember/routing/route'; + +export default class PublicPagesDocsMigrate80To90Route extends Route {} diff --git a/docs/app/templates/public-pages/docs.gts b/docs/app/templates/public-pages/docs.gts index fb2e4dbf..b2e0dc4a 100644 --- a/docs/app/templates/public-pages/docs.gts +++ b/docs/app/templates/public-pages/docs.gts @@ -41,6 +41,10 @@ const groupedSections = [ id: 'upgrade', groupName: 'Upgrade', options: [ + { + route: 'public-pages.docs.migrate-8-0-to-9-0', + text: 'Migrate from 8.0 to 9.0', + }, { route: 'public-pages.docs.migrate-7-0-to-8-0', text: 'Migrate from 7.0 to 8.0', diff --git a/docs/app/templates/public-pages/docs/migrate-7-0-to-8-0.gts b/docs/app/templates/public-pages/docs/migrate-7-0-to-8-0.gts index e2cc73fd..0d06c16c 100644 --- a/docs/app/templates/public-pages/docs/migrate-7-0-to-8-0.gts +++ b/docs/app/templates/public-pages/docs/migrate-7-0-to-8-0.gts @@ -39,9 +39,9 @@ import { LinkTo } from '@ember/routing';
< Animations + >< Migrate from 8.0 to 9.0 +

Migrate from 8.0 to 9.0

+ +

Before migrating to 9.x, you should first update to the latest 8.x release, + as most of the breaking changes were introduced in 8.x.

+ +

Breaking changes

+ +
    +
  • +

    The minimum required Ember version is now 4.12.

    +
    • +
  • +

    + Passing + components + as strings is no longer supported. You must now pass all components as + contextual components.
    + (Ember deprecated passing components as strings in version + 3.25. In line with this change, we have removed the dependency on + the deprecated + @embroider/util + package.) +

    +
    • +
  • +

    + node-sass + has been deprecated for many years and is no longer supported. Please + migrate to + sass + or + sass-embedded. +

    +
    • +
  • +

    + Passing + @dropdownId + wasn't working correctly without using custom modifiers and was + undocumented. Remove this parameter and use the + uniqueId + property from the public API instead. +
    + (Deprecation added in 8.8) +

    +
    • +
  • +

    + Passing configurations to + ember-basic-dropdown + over + ember-cli-build.js + was removed. You should pass them over + setConfig + (see the installation guide) +
    + (Deprecation added in 8.9) +

    +
    • +
  • +

    + ember-basic-dropdown previously read the value of + APP.rootElement + from + ember-cli-build.js. According to the v2 addon + specification, addons should not read configurations from + ember-cli-build.js. You must now pass this value via + setConfig + (see the installation guide). +
    + (Deprecation added in 8.9) +

    +
    • +
+ +
+ < Animations + Migrate from 7.0 to 8.0 > +
+ diff --git a/docs/tests/unit/routes/public-pages/docs/migrate-8-0-to-9-0-test.ts b/docs/tests/unit/routes/public-pages/docs/migrate-8-0-to-9-0-test.ts new file mode 100644 index 00000000..45e42428 --- /dev/null +++ b/docs/tests/unit/routes/public-pages/docs/migrate-8-0-to-9-0-test.ts @@ -0,0 +1,13 @@ +import { module, test } from 'qunit'; +import { setupTest } from 'docs/tests/helpers'; + +module('Unit | Route | public-pages/docs/migrate-8-0-to-9-0', function (hooks) { + setupTest(hooks); + + test('it exists', function (assert) { + const route = this.owner.lookup( + 'route:public-pages/docs/migrate-8-0-to-9-0', + ); + assert.ok(route); + }); +});