From 907755c6ab804cc7a727fd6a20d6043ab087ddba Mon Sep 17 00:00:00 2001 From: Patrik Oldsberg Date: Tue, 14 Nov 2023 14:29:36 +0100 Subject: [PATCH 1/3] docs: add 1.20 release notes Signed-off-by: Patrik Oldsberg --- docs/releases/v1.20.0.md | 50 ++++++++++++++++++++++++++++++++++ microsite/docusaurus.config.js | 2 +- microsite/sidebars.json | 1 + 3 files changed, 52 insertions(+), 1 deletion(-) create mode 100644 docs/releases/v1.20.0.md diff --git a/docs/releases/v1.20.0.md b/docs/releases/v1.20.0.md new file mode 100644 index 0000000000..2ad27f6b38 --- /dev/null +++ b/docs/releases/v1.20.0.md @@ -0,0 +1,50 @@ +--- +id: v1.20.0 +title: v1.20.0 +description: Backstage Release v1.20.0 +--- + +These are the release notes for the v1.20.0 release of [Backstage](https://backstage.io/). + +A huge thanks to the whole team of maintainers and contributors as well as the amazing Backstage Community for the hard work in getting this release developed and done. + +## Highlights + +### Support for experimental type build has been removed + +The `--experimental-type-build` option is no longer supported by any commands in the Backstage CLI. Existing usage should be migrated to using [subpath exports](https://backstage.io/docs/local-dev/cli-build-system#subpath-exports) instead. + +### Experimental support for Vite ⚡ + +Due to some concerns about performance in larger monorepo setups and hot-reloading times, we’re looking to replace [Webpack](https://webpack.js.org/) with [Vite](https://vitejs.dev/) longer term, and in this release we’re shipping experimental support for Vite behind a `EXPERIMENTAL_VITE` environment variable flag when running `yarn start` in the frontend. + +Please reach out by [creating a GitHub issue](https://github.com/backstage/backstage/issues/new/choose) with any problems that you might be running into when using this experimental feature. + +### Scaffolder: `react-jsonschema-form@v5` + Design tweaks 💅 + +It’s finally here. We’ve shipped support for `react-jsonschema-form@v5` which **should** be a completely non-breaking change for end users. We’ve also tweaked some of the designs for some of the new Scaffolder Pages. You can read more in the [upgrade to `@rjsf/*` v5 docs](https://backstage.io/docs/features/software-templates/migrating-to-rjsf-v5) + +### Catalog Presentation API + +The Catalog plugin now uses the `EntityPresentationApi` to decide how entities are rendered in the UI. This includes fetching entities in the background in order to show entities using their `metadata.title`. For more information, including how to customize the presentation, see [the PR](https://github.com/backstage/backstage/pull/17474), (documentation is in the works!). + +## Security Fixes + +This release does not contain any security fixes. + +## Upgrade path + +We recommend that you keep your Backstage project up to date with this latest release. For more guidance on how to upgrade, check out the documentation for [keeping Backstage updated](https://backstage.io/docs/getting-started/keeping-backstage-updated). + +## Links and References + +Below you can find a list of links and references to help you learn about and start using this new release. + +- [Backstage official website](https://backstage.io/), [documentation](https://backstage.io/docs/), and [getting started guide](https://backstage.io/docs/getting-started/) +- [GitHub repository](https://github.com/backstage/backstage) +- Backstage's [versioning and support policy](https://backstage.io/docs/overview/versioning-policy) +- [Community Discord](https://discord.gg/backstage-687207715902193673) for discussions and support +- [Changelog](https://github.com/backstage/backstage/tree/master/docs/releases/v1.20.0-changelog.md) +- Backstage [Demos](https://backstage.io/demos), [Blog](https://backstage.io/blog), [Roadmap](https://backstage.io/docs/overview/roadmap) and [Plugins](https://backstage.io/plugins) + +Sign up for our [newsletter](https://info.backstage.spotify.com/newsletter_subscribe) if you want to be informed about what is happening in the world of Backstage. diff --git a/microsite/docusaurus.config.js b/microsite/docusaurus.config.js index f4dd76b8e3..7a01498646 100644 --- a/microsite/docusaurus.config.js +++ b/microsite/docusaurus.config.js @@ -178,7 +178,7 @@ module.exports = { position: 'left', }, { - to: 'docs/releases/v1.19.0', + to: 'docs/releases/v1.20.0', label: 'Releases', position: 'left', }, diff --git a/microsite/sidebars.json b/microsite/sidebars.json index 9377e196ee..c9b1c99eba 100644 --- a/microsite/sidebars.json +++ b/microsite/sidebars.json @@ -1,6 +1,7 @@ { "releases": { "Release Notes": [ + "releases/v1.20.0", "releases/v1.19.0", "releases/v1.18.0", "releases/v1.17.0", From 3a333afde531739ecba8e98fbcf6c8c0d6f6d921 Mon Sep 17 00:00:00 2001 From: Patrik Oldsberg Date: Tue, 14 Nov 2023 16:26:56 +0100 Subject: [PATCH 2/3] Update docs/releases/v1.20.0.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Fredrik Adelöw Signed-off-by: Patrik Oldsberg --- docs/releases/v1.20.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/releases/v1.20.0.md b/docs/releases/v1.20.0.md index 2ad27f6b38..56d2ce0d08 100644 --- a/docs/releases/v1.20.0.md +++ b/docs/releases/v1.20.0.md @@ -16,7 +16,7 @@ The `--experimental-type-build` option is no longer supported by any commands in ### Experimental support for Vite ⚡ -Due to some concerns about performance in larger monorepo setups and hot-reloading times, we’re looking to replace [Webpack](https://webpack.js.org/) with [Vite](https://vitejs.dev/) longer term, and in this release we’re shipping experimental support for Vite behind a `EXPERIMENTAL_VITE` environment variable flag when running `yarn start` in the frontend. +Due to some concerns about performance in larger monorepo setups and hot-reloading times, we’re looking to replace [Webpack](https://webpack.js.org/) with [Vite](https://vitejs.dev/) longer term, and in this release we’re shipping experimental support for Vite behind an `EXPERIMENTAL_VITE` environment variable flag when running `yarn start` in the frontend. Please reach out by [creating a GitHub issue](https://github.com/backstage/backstage/issues/new/choose) with any problems that you might be running into when using this experimental feature. From 083265bd93596eec71bb4fd8a65da8f9df08751d Mon Sep 17 00:00:00 2001 From: Patrik Oldsberg Date: Tue, 14 Nov 2023 16:27:59 +0100 Subject: [PATCH 3/3] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Fredrik Adelöw Signed-off-by: Patrik Oldsberg --- docs/releases/v1.20.0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/releases/v1.20.0.md b/docs/releases/v1.20.0.md index 56d2ce0d08..921b8219fb 100644 --- a/docs/releases/v1.20.0.md +++ b/docs/releases/v1.20.0.md @@ -22,11 +22,11 @@ Please reach out by [creating a GitHub issue](https://github.com/backstage/backs ### Scaffolder: `react-jsonschema-form@v5` + Design tweaks 💅 -It’s finally here. We’ve shipped support for `react-jsonschema-form@v5` which **should** be a completely non-breaking change for end users. We’ve also tweaked some of the designs for some of the new Scaffolder Pages. You can read more in the [upgrade to `@rjsf/*` v5 docs](https://backstage.io/docs/features/software-templates/migrating-to-rjsf-v5) +It’s finally here. We’ve shipped support for `react-jsonschema-form@v5` which **should** be a completely non-breaking change for end users. We’ve also tweaked some of the designs for some of the new Scaffolder Pages. You can read more in the [relevant migration docs](https://backstage.io/docs/features/software-templates/migrating-to-rjsf-v5) ### Catalog Presentation API -The Catalog plugin now uses the `EntityPresentationApi` to decide how entities are rendered in the UI. This includes fetching entities in the background in order to show entities using their `metadata.title`. For more information, including how to customize the presentation, see [the PR](https://github.com/backstage/backstage/pull/17474), (documentation is in the works!). +The Catalog plugin now uses the `EntityPresentationApi` to decide how entities are rendered in the UI. This includes fetching catalog data in the background in order to show entities using their `metadata.title`. For more information, including how to customize the presentation, see [the PR](https://github.com/backstage/backstage/pull/17474), (documentation is in the works!). ## Security Fixes