Skip to content

Commit e7b5b0e

Browse files
committed
Refactor Prerequisites section
1 parent bb7a936 commit e7b5b0e

File tree

2 files changed

+15
-43
lines changed

2 files changed

+15
-43
lines changed
Binary file not shown.

README.md

Lines changed: 15 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -4,62 +4,34 @@
44

55
## Background
66

7-
There are many great resources for learning CMS12 and Commerce14:
8-
9-
- The official developer documentation has been updated:
10-
https://world.optimizely.com
11-
- The official user guild has been updated:
12-
https://webhelp.optimizely.com
13-
- Mark Price and Scott Reed host a masterclass on .NET5:
14-
https://www.optimizely.com/support/education/product/migrating-to-optimizely-cms-12-and-commerce-14
15-
16-
...and so on.
17-
But there aren’t many resources for upgrading from CMS 11 / Commerce 13
7+
There are many great resources for learning how to build a new solution using CMS 12 and Commerce 14. The official [developer documentation](https://world.optimizely.com) has been updated, the official [user guide](https://webhelp.optimizely.com) has been updated, and an excellent [masterclass](https://www.optimizely.com/support/education/product/migrating-to-optimizely-cms-12-and-commerce-14) is hosted by Mark Price and Scott Reed (to name a few). But there aren’t many resources sharing information on how to take an existing CMS 11 / Commerce 13 solution and upgrade it to .NET 5+.
188

199
## Prerequisites
2010

21-
Phase 0: Stuff to do before you begin
22-
23-
### Read the official documentation
24-
25-
1. Upgrading to Content Cloud (CMS 12)
26-
https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/upgrading-to-content-cloud-cms-12
27-
28-
2. Breaking changes in Content Cloud (CMS 12)
29-
https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/breaking-changes-in-content-cloud-cms-12
30-
31-
3. System requirements for Optimizely
32-
https://docs.developers.optimizely.com/content-cloud/v12.0.0-content-cloud/docs/system-requirements-for-optimizely
33-
34-
### Be on .NET Framework 4.7.2 or higher
35-
36-
CMS11 only requires .NET Framework 4.6.1, but Microsoft recommends being on 4.7.2 or higher when using Upgrade-Assistant
37-
38-
- https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/system-requirements-for-optimizely
39-
- https://docs.microsoft.com/en-us/dotnet/core/porting/premigration-needed-changes
11+
### 1. Read the official documentation
4012

41-
### Update to the latest version of CMS11 (Commerce13) before upgrading
13+
1. [Upgrading to Content Cloud (CMS 12)](https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/upgrading-to-content-cloud-cms-12)
14+
2. [Breaking changes in Content Cloud (CMS 12)](https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/breaking-changes-in-content-cloud-cms-12)
15+
3. [System requirements for Optimizely (CMS 12)](https://docs.developers.optimizely.com/content-cloud/v12.0.0-content-cloud/docs/system-requirements-for-optimizely)
4216

43-
The official documentation doesn’t explicitly say to do this, but I can’t think of any reason not to.
17+
### 2. Be on .NET Framework 4.7.2 or higher
4418

45-
### Check the status of add-on packages
19+
CMS 11 only [requires](https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/system-requirements-for-optimizely) .NET Framework 4.6.1, but Microsoft [recommends](https://docs.microsoft.com/en-us/dotnet/core/porting/premigration-needed-changes) being on 4.7.2 or higher when using Upgrade-Assistant
4620

47-
- Official CMS/Commerce add-on platform compatibility:
48-
https://docs.developers.optimizely.com/integrations/v1.1.0-apps-and-integrations/docs/add-ons-platform-compatibility
21+
### 3. Update to the latest version of CMS11 (Commerce13) before upgrading
4922

50-
- Official big list of package migration status:
51-
https://world.optimizely.com/resources/net5/add-ons
23+
The official documentation doesn't explicitly say to do this, but is there any reason _not_ to?
5224

53-
### Check the status of add-on packages
25+
### 4. Check the status of add-on packages
5426

55-
Give yourself time to check the status of your favorite third party add-ons.
27+
Optimizely maintains a list of the .NET 5 migration status of the official platform and addon NuGet packages:
5628

57-
Having no workaround for unsupported add-ons could derail your whole upgrade project. Know what you’re getting into.
29+
- [Add-ons platform compatibility (Optimizely Developer Docs)](https://docs.developers.optimizely.com/integrations/v1.1.0-apps-and-integrations/docs/add-ons-platform-compatibility)
30+
- [Add-Ons Status (Optimizely.com)](https://world.optimizely.com/resources/net5/add-ons)
5831

59-
Note: Some old, .NET Framework add-ons will still work, just with a warning.
32+
No such list exists for unofficial add-ons (as of this writing). So, when planning the upgrade, give yourself time to check the status of your favorite third party add-ons. Having no workaround for unsupported add-ons could derail your whole upgrade project. Know what you’re getting into.
6033

61-
Example: Authorize.Net.
62-
There is no .NET Core+ package, but it still compiles and runs.
34+
Note that some old, .NET Framework add-ons will still work, just with a warning. For example: Authorize.Net. There is no .NET Core+ package, but it still compiles and runs.
6335

6436
## Upgrade-Assistant
6537

0 commit comments

Comments
 (0)