Merge pull request #778 from DNNCommunity/feature/update-upgrade-documentation

Updates to the Upgrade Path Page & 10.02.00 and later Updates

Author: david-poindexter

content/getting-started/setup/upgrades/post-10.2.0-steps.md

@@ -16,29 +16,35 @@ Before starting the upgrade process, it is recommended to have a very clear unde
 
 * Know the current version of DNN Platform.
 
-* Know the desired version of DNN Platform and download the appropriate "Upgrade" ZIP package from [the official repository on GitHub](https://github.com/dnnsoftware/DNN.Platform/releases). The file can be found in the **Assets** section for the desired version release and will have a naming convention like **DNN_Platform_10.2.1_Upgrade.zip**.
+* Know the [suggested upgrade path](xref:setup-upgrades-suggested-upgrade-path) and take the necessary planning steps to make each of these upgrade steps for the best success.
 
-* Know the [suggested upgrade path](xref:setup-upgrades-suggested-upgrade-path) from the current version of DNN Platform and download all appropriate "Upgrade" ZIP packages from the above referenced GitHub link.
+* Download the appropriate "Upgrade" ZIP package for your upgrade from [the official repository on GitHub](https://github.com/dnnsoftware/DNN.Platform/releases). The file can be found in the **Assets** section for the desired version release and will have a naming convention like **DNN_Platform_10.2.1_Upgrade.zip**.
 
 * Know any changes to the minimum requirements for the desired version of DNN Platform and plan for implementation accordingly. 
 
-* Know upgrade requirements (if applicable) for any installed third-party extensions and plan for implementation accordingly.
+* Please know the upgrade requirements (if applicable) for any installed third-party extensions and plan for implementation accordingly.
 
-* If possible, plan to test the upgrade in a non-production environment prior to attempting in production.
+* If possible, plan to test the upgrade in a non-production environment prior to attempting it in production.
+
+> [!Tip]
+> If you use third-party modules, subscribe to the vendors' newsletters or otherwise to keep up to date with their releases and DNN Version support.
 
 ## Step 2 - Backup Files & Database
 All files, folders and subfolders (root and below) can be manually copied to a temporary location outside of the website directory structure.
 
-The database can be backed up using Microsoft SQL Server Management Studio (SSMS).
+The database can be backed up using Microsoft SQL Server Management Studio (SSMS) following standard backup rocesses.
 
 If this level of access to the server is not possible, there are other options depending on the hosting environment and available third-party extensions.  Following is a short list of alternate backup options.
 
 * Secure File Transfer Protocol (SFTP) or File Transfer Protocol (FTP) in combination with remote Microsoft SQL Server Management Studio (SSMS).
 * Control Panel (e.g., Plesk)
 * DNN Backup (3rd-party module by Evotiva)
 
+> [!Tip]
+> Be sure that you have tested/validated your backup process before continuing if using a new process.
+
 ## Step 3 - Upload Upgrade Package
-Login has a SuperUser (Host) and navigate to: Servers => System Info => Upgrades.
+Login as a SuperUser (Host) and navigate to: Settings => Servers => System Info => Upgrades.
 Click on "Upload Package" and upload the previously downloaded upgrade zip file.
 The system will validate the upgrade package and warn about potential issues if detected.
 
@@ -50,6 +56,9 @@ Review upgrade results for any errors during the upgrade process. If no errors,
 
 If any errors are experienced, either resolve the errors (_contingent upon experience and skill level_), or restore website from the backup created in **Step 2**.
 
+> [!Warning]
+> If restoring from a backup, it is important to ALWAYS restore the website files & database at the same time, even if you don't believe the upgrade may have touched the database.
+
 > [!NOTE]
 > If you need to restore a website, it is important to first remove all files.  Then, replace it with the backup copy. It is not adequate to simply apply the backup over the top of the failed upgrade site.  Failure to follow this guidance can result in a non-functional, restored site.
 

content/getting-started/setup/upgrades/suggested-upgrade-path/index.md

@@ -31,13 +31,17 @@ The below is, of course, subject to change. If your current version of DNN Platf
 |[09.01.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.1.1)|[09.03.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.3.2)|
 |[09.03.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.3.2)|[09.13.09](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.09)|
 |[09.13.09](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.09)|[10.02.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.2.1)|
+|[10.02.01](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.02.01)|[10.02.02](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v10.2.2)|
 
 > [!NOTE]
-> If you are in a situation where you are unable to make the 09.13.09 -> 10.x upgrade, there is a hot-fix release [09.13.10](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.10), this was a special release that contains security patches through the DNN 10.02.00 release and can be used during periods when a 10.x upgrade is not possible.  For a successful upgrade, it is NOT necessary to stop at 09.13.10 prior to upgrading to 10.x.  There is NO guarantee that any future 9.13.x releases will be made, therefore it is suggested to try to prepare for a 10.x upgrade as soon as practical.
+> If you are in a situation where you are unable to make the 09.13.09 -> 10.x upgrade, there is a hot-fix release [09.13.10](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.10). This was a special release that contains security patches through the DNN 10.02.00 release and can be used during periods when a 10.x upgrade is not possible.  For a successful upgrade, it is NOT necessary to stop at 09.13.10 prior to upgrading to 10.x.  There is NO guarantee that any future 9.13.x releases will be made, therefore it is suggested to try to prepare for a 10.x upgrade as soon as practical.
 
 > [!TIP]
 > **Upgrade Notes:** DotNetNuke has been around since 2002, and in that time has had a number of changes which can complicate matters during the process of upgrading through different versions. These include:
 
+> [!NOTE]
+> If upgrading from DNN 10.02.02 and later, it is strongly recommended to follow the new upgrade process outlined in the [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0)
+
 ## Requirements Changes & Prerequisites
 - The changeover from DNN 3.x to DNN 4.x - DNN 3.x used ASP.NET 1.1, whereas DNN 4.x and above require ASP.NET 2.0.
 - Editions prior to 4.6.2 - Prior to 4.6.2 site admins had to manually merge a number of key fields in web.config such as the machinekey and both connection strings. With 4.6.2 DotNetNuke introduced functionality known as xmlmerge which automatically does the web.config merging on your behalf.