From 3d17589e622c5a7c52f5d2c12adf970807c95e0a Mon Sep 17 00:00:00 2001 From: Jordan McFarlane Date: Tue, 4 Jun 2024 10:55:42 +0200 Subject: [PATCH 1/7] Add info for mid-year Heartcore migration --- umbraco-heartcore/migration-2024.md | 45 +++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 umbraco-heartcore/migration-2024.md diff --git a/umbraco-heartcore/migration-2024.md b/umbraco-heartcore/migration-2024.md new file mode 100644 index 00000000000..5440e72994f --- /dev/null +++ b/umbraco-heartcore/migration-2024.md @@ -0,0 +1,45 @@ +# Heartcore Migration 2024 + +From July through to the end of August 2024 there is a planned major migration for all Heartcore sites created prior to 12th February 2024. This article will help you understand what to expect from it. + +## Benefits +In addition to a range of quality-of-life improvements and bug fixes, after the upgrade you can expect to see the following features: +* Support for he Block Grid Editor for managing two-dimensional content layouts. +* Rich text editor enhancements. +* Management API support for property type configuration. +* Better backoffice performance across the board. + +For more information about these and other changes, take a look at the release notes for [February](release-notes/2024-02-releasenotes.md) and [April](release-notes/2024-04-releasenotes.md). + +## What to Expect +Your project will be scheduled for upgrade in either July or August. You will receive a notification approximately two weeks prior, with the morning or afternoon of a specific day on which the migration will happen. + +The migration will cause a brief partial disruption to service and also contains one breaking change that will affect some sites. + +### During Maintenance +You can expect the following services to be affected for approximately one hour during the migration: +* **CMS backoffice** - Users will be unable to log in and author changes to settings, content, and media. +* **Management API** - Applications will be unable to call Management API endpoints. Note that this also impacts the form submission endpoint, which will return HTTP 500-series error responses during the outage window. + +### After Maintenence +After the migration ***some*** non-ASCII characters in content and media URLs will be substituted with a different ascii character sequence in the new version. + +{% hint style="danger" %} +**This is a breaking change.** Unless your application has been built with redirection in mind, then external links to affected content items may no longer work post-migration. +{% endhint %} + +For a non-exhaustive example, see the below table to see how some character substitutions will (or won't) change: + +| Character | Previous Substitution | New Substitution | +|-----------|-----------------------|------------------| +| å | a | aa | +| ø | o | oe | +| ü | u | ue | +| æ | ae | ae | +| ß | ss | ss | + +This change will only affect the URLs generated when content is published or media is saved. It will not affect property values of any content. + +The Redirect API will contain a reference to the pre-migration URL for each item. In order for your applications to seamlessly handle the change, it is recommended you query this API to determine if a URL has changed and serve an HTTP 301 - Permanent Redirect response if so. + +If your applications will be affected by this change and you need to know more, please reach out via support ticket. \ No newline at end of file From e87f9ce44a43d2a08796f6d3273dd7d2560dd064 Mon Sep 17 00:00:00 2001 From: Jordan McFarlane Date: Tue, 4 Jun 2024 11:08:00 +0200 Subject: [PATCH 2/7] Rename 2024 migration, add to summary.md --- umbraco-heartcore/SUMMARY.md | 3 ++- .../core-dependency-upgrade.md} | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) rename umbraco-heartcore/{migration-2024.md => release-notes/core-dependency-upgrade.md} (98%) diff --git a/umbraco-heartcore/SUMMARY.md b/umbraco-heartcore/SUMMARY.md index 1ca44a492ff..d795d103362 100644 --- a/umbraco-heartcore/SUMMARY.md +++ b/umbraco-heartcore/SUMMARY.md @@ -67,4 +67,5 @@ ## Release Notes * [February 2024](release-notes/2024-02-releasenotes.md) -* [April 2024](release-notes/2024-04-releasenotes.md) \ No newline at end of file +* [April 2024](release-notes/2024-04-releasenotes.md) +* [Core Dependency Upgrade](release-notes/core-dependency-upgrade.md) \ No newline at end of file diff --git a/umbraco-heartcore/migration-2024.md b/umbraco-heartcore/release-notes/core-dependency-upgrade.md similarity index 98% rename from umbraco-heartcore/migration-2024.md rename to umbraco-heartcore/release-notes/core-dependency-upgrade.md index 5440e72994f..857ef3d0e5f 100644 --- a/umbraco-heartcore/migration-2024.md +++ b/umbraco-heartcore/release-notes/core-dependency-upgrade.md @@ -1,4 +1,4 @@ -# Heartcore Migration 2024 +# Heartcore Core Dependency Upgrade From July through to the end of August 2024 there is a planned major migration for all Heartcore sites created prior to 12th February 2024. This article will help you understand what to expect from it. From 37e1ad640d094415e5e9a675932a95d7ce88186e Mon Sep 17 00:00:00 2001 From: Jordan McFarlane Date: Tue, 4 Jun 2024 11:10:37 +0200 Subject: [PATCH 3/7] Make Vale happy --- umbraco-heartcore/release-notes/core-dependency-upgrade.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/umbraco-heartcore/release-notes/core-dependency-upgrade.md b/umbraco-heartcore/release-notes/core-dependency-upgrade.md index 857ef3d0e5f..6bcaa724b7e 100644 --- a/umbraco-heartcore/release-notes/core-dependency-upgrade.md +++ b/umbraco-heartcore/release-notes/core-dependency-upgrade.md @@ -19,7 +19,7 @@ The migration will cause a brief partial disruption to service and also contains ### During Maintenance You can expect the following services to be affected for approximately one hour during the migration: * **CMS backoffice** - Users will be unable to log in and author changes to settings, content, and media. -* **Management API** - Applications will be unable to call Management API endpoints. Note that this also impacts the form submission endpoint, which will return HTTP 500-series error responses during the outage window. +* **Management API** - Applications will be unable to call Management API endpoints. This also impacts the form submission endpoint, which will return HTTP 500-series error responses during the outage window. ### After Maintenence After the migration ***some*** non-ASCII characters in content and media URLs will be substituted with a different ascii character sequence in the new version. @@ -40,6 +40,6 @@ For a non-exhaustive example, see the below table to see how some character subs This change will only affect the URLs generated when content is published or media is saved. It will not affect property values of any content. -The Redirect API will contain a reference to the pre-migration URL for each item. In order for your applications to seamlessly handle the change, it is recommended you query this API to determine if a URL has changed and serve an HTTP 301 - Permanent Redirect response if so. +The Redirect API will contain a reference to the pre-migration URL for each item. In order for your applications to seamlessly handle the change, it is recommended they query this API to determine if a URL has changed. If so, they should serve an HTTP 301 - Permanent Redirect response to the new URL. If your applications will be affected by this change and you need to know more, please reach out via support ticket. \ No newline at end of file From d250aa942325701b5bb5cf952f31dce9c877c690 Mon Sep 17 00:00:00 2001 From: jonat123 <54025331+jonat123@users.noreply.github.com> Date: Tue, 4 Jun 2024 11:19:08 +0200 Subject: [PATCH 4/7] Update umbraco-heartcore/release-notes/core-dependency-upgrade.md --- umbraco-heartcore/release-notes/core-dependency-upgrade.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-heartcore/release-notes/core-dependency-upgrade.md b/umbraco-heartcore/release-notes/core-dependency-upgrade.md index 6bcaa724b7e..2d71f79c423 100644 --- a/umbraco-heartcore/release-notes/core-dependency-upgrade.md +++ b/umbraco-heartcore/release-notes/core-dependency-upgrade.md @@ -4,7 +4,7 @@ From July through to the end of August 2024 there is a planned major migration f ## Benefits In addition to a range of quality-of-life improvements and bug fixes, after the upgrade you can expect to see the following features: -* Support for he Block Grid Editor for managing two-dimensional content layouts. +* Support for the Block Grid Editor for managing two-dimensional content layouts. * Rich text editor enhancements. * Management API support for property type configuration. * Better backoffice performance across the board. From c058c17f4db67b998d77d116d494a5197554b744 Mon Sep 17 00:00:00 2001 From: jonat123 <54025331+jonat123@users.noreply.github.com> Date: Tue, 4 Jun 2024 11:23:58 +0200 Subject: [PATCH 5/7] Update umbraco-heartcore/release-notes/core-dependency-upgrade.md --- umbraco-heartcore/release-notes/core-dependency-upgrade.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-heartcore/release-notes/core-dependency-upgrade.md b/umbraco-heartcore/release-notes/core-dependency-upgrade.md index 2d71f79c423..5abdc48c45d 100644 --- a/umbraco-heartcore/release-notes/core-dependency-upgrade.md +++ b/umbraco-heartcore/release-notes/core-dependency-upgrade.md @@ -9,7 +9,7 @@ In addition to a range of quality-of-life improvements and bug fixes, after the * Management API support for property type configuration. * Better backoffice performance across the board. -For more information about these and other changes, take a look at the release notes for [February](release-notes/2024-02-releasenotes.md) and [April](release-notes/2024-04-releasenotes.md). +For more information about these and other changes, take a look at the release notes for [February](./2024-02-releasenotes.md) and [April](./2024-04-releasenotes.md). ## What to Expect Your project will be scheduled for upgrade in either July or August. You will receive a notification approximately two weeks prior, with the morning or afternoon of a specific day on which the migration will happen. From f2a6084fcfc0929d0919cd940f5644f6c615d1a2 Mon Sep 17 00:00:00 2001 From: jonat123 <54025331+jonat123@users.noreply.github.com> Date: Tue, 4 Jun 2024 11:27:00 +0200 Subject: [PATCH 6/7] Update umbraco-heartcore/release-notes/core-dependency-upgrade.md --- umbraco-heartcore/release-notes/core-dependency-upgrade.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-heartcore/release-notes/core-dependency-upgrade.md b/umbraco-heartcore/release-notes/core-dependency-upgrade.md index 5abdc48c45d..b1ec98cfc2b 100644 --- a/umbraco-heartcore/release-notes/core-dependency-upgrade.md +++ b/umbraco-heartcore/release-notes/core-dependency-upgrade.md @@ -22,7 +22,7 @@ You can expect the following services to be affected for approximately one hour * **Management API** - Applications will be unable to call Management API endpoints. This also impacts the form submission endpoint, which will return HTTP 500-series error responses during the outage window. ### After Maintenence -After the migration ***some*** non-ASCII characters in content and media URLs will be substituted with a different ascii character sequence in the new version. +After the migration ***some*** non-ASCII characters in content and media URLs will be substituted with a different ASCII character sequence in the new version. {% hint style="danger" %} **This is a breaking change.** Unless your application has been built with redirection in mind, then external links to affected content items may no longer work post-migration. From 2af4f1ed2f480bac11b59a492c6d6b7fb1a76608 Mon Sep 17 00:00:00 2001 From: jonat123 <54025331+jonat123@users.noreply.github.com> Date: Tue, 4 Jun 2024 11:29:37 +0200 Subject: [PATCH 7/7] Update umbraco-heartcore/release-notes/core-dependency-upgrade.md --- umbraco-heartcore/release-notes/core-dependency-upgrade.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/umbraco-heartcore/release-notes/core-dependency-upgrade.md b/umbraco-heartcore/release-notes/core-dependency-upgrade.md index b1ec98cfc2b..9f90dced912 100644 --- a/umbraco-heartcore/release-notes/core-dependency-upgrade.md +++ b/umbraco-heartcore/release-notes/core-dependency-upgrade.md @@ -42,4 +42,4 @@ This change will only affect the URLs generated when content is published or med The Redirect API will contain a reference to the pre-migration URL for each item. In order for your applications to seamlessly handle the change, it is recommended they query this API to determine if a URL has changed. If so, they should serve an HTTP 301 - Permanent Redirect response to the new URL. -If your applications will be affected by this change and you need to know more, please reach out via support ticket. \ No newline at end of file +If your applications will be affected by this change and you need to know more, please reach out via a support ticket. \ No newline at end of file