From 8782b840b3cfbdf04aa75fc6c2d1f6de387b2508 Mon Sep 17 00:00:00 2001 From: "Sean G. Wright" Date: Fri, 2 Aug 2024 14:34:21 -0400 Subject: [PATCH] docs(Usage-Guide): add migration paths tables --- docs/Usage-Guide.md | 142 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) diff --git a/docs/Usage-Guide.md b/docs/Usage-Guide.md index 7b320352..9ef4ad1a 100644 --- a/docs/Usage-Guide.md +++ b/docs/Usage-Guide.md @@ -50,3 +50,145 @@ The migration currently supports the Kentico Xperience 13, Kentico 12 or Kentico The full set of upgrade paths to Xperience by Kentico can be seen below. [![Full Kentico upgrade paths to Xperience by Kentico](/images/xperience-by-kentico-migration-toolkit-kentico-migration-tool-full-embedded.jpg)](/images/xperience-by-kentico-migration-toolkit-kentico-migration-tool-full-embedded.jpg) + +## Migration paths review + +As previously mentioned, there are multiple upgrade paths available, particularly when upgrading a project from Kentico 12 to Xperience by Kentico. This section provides an overview of what to expect from each upgrade variant, outlining their respective benefits and costs. This information should help in your strategic decision-making process. + +This table shows, for each upgrade path, expectations customers should have for all the steps required to complete the process. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameBuild a new applicationMigrate Portal Engine WebsiteUpgrade to ASP.NET CoreRewrite Data AccessUpdate to Xperience by Kentico Page Builder
+ Kentico 11 ->
+ Xperience by Kentico +
+ Kentico 12 Portal Engine ->
+ Xperience by Kentico +
+ Kentico 10, Kentico 11 ->
+ Kentico 12 Portal Engine ->
+ Kentico 12 MVC ->
+ Kentico Xperience 13 ->
+ Xperience by Kentico +
+ Kentico 12 MVC ->
+ Xperience by Kentico +
+ Kentico 12 MVC ->
+ Kentico Xperience 13 ->
+ Xperience by Kentico +
+ Kentico Xperience 13 MVC 5 ->
+ Xperience by Kentico +
+ Kentico Xperience 13 ASP.NET Core ->
+ Xperience by Kentico +
+ +The table below compares the benefits and costs of the various upgrade paths to Xperience by Kentico. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameBenefitsCosts
Kentico 11,
Kentico 12 Portal Engine ->
Xperience by Kentico
• Start from “scratch” without throwing away valuable structured content
• Very little code might be relevant from this technology and time period, so there’s little loss in building a new application
• Marketing teams can re-evaluate their content and marketing strategy without being limited by choices that were made 4-5 years ago.
• Full application build
• If content was not structured, there might be very little that can be migrated
• Longer development time with fewer “rest stops” for a team.
Kentico 10, Kentico 11 ->
Kentico 12 Portal Engine ->
Kentico 12 MVC ->
Kentico Xperience 13 ->
Xperience by Kentico
• Many investments made in original solution can be carried forward
• Enables many stopping points to define boundaries of a project.
• Gives development and marketing teams time to become adjusted to new strategies and technologies
• Presentation/design and some page creation workflow for marketers can be preserved exactly, which means less re-training.
• Might require higher total cost than direct migration to XbyK with all stopping points and intermediate upgrades.
• “Lift and shift” mindset. Marketing strategy, design, content modeling, and technology choices from the Portal Engine era might not be relevant today and might lead to a poor implementation and experience in XbyK.
Kentico 12 MVC ->
Xperience by Kentico
• No intermediate KX13 upgrade required
• Well-built K12 MVC solutions will become well-built XbyK solutions
• Team needs to convert entire project from ASP.NET MVC 5 to ASP.NET Core and this needs to be weighed against the cost of writing some functionality from scratch
• Many customers/partners did not understand MVC when K12 MVC was released and didn’t design solutions as well as they do today which could lead to unfavorable constraints in XbyK for marketers.
Rich-text-heavy / website-focused content will still have to be migrated manually and might block marketers from taking advantage of other channels.
“Refurbishing a horse-drawn carriage in the era of electric cars”
“Does a customer want a site using carousels, Bootstrap 3, and unstructured content in 2024?”
Kentico 12 MVC ->
Kentico Xperience 13 ->
Xperience by Kentico
• Benefits are similar to those of K12 PE → K12 MVC → KX13 → XbyK• Costs are similar to the costs of K12 PE → K12 MVC → KX13 → XbyK
+ +## **Do you need additional assistance?** + +While we have made every effort to provide comprehensive documentation, tools, and best practices to assist you in your upgrade process, there may be instances where you would prefer to consult with Kentico experts for additional guidance. + +Our consulting team is fully committed to providing help and support to our partners. We offer a [Pre-upgrade audit service](https://www.kentico.com/services/consulting/migration-and-upgrade-assessment) specifically designed to help you avoid pitfalls associated with upgrades. You can find more information about this service [on our website](https://www.kentico.com/services/consulting/migration-and-upgrade-assessment).