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';
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.
+ +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)
+