Add steps for updating template precedence values (#44642)

1 files changed, 4 insertions, 0 deletions

diff --git a/docs/UpdatingMajorVersionAndTFM.md b/docs/UpdatingMajorVersionAndTFM.md
index 2c85691772..43224ee1f7 100644
--- a/docs/UpdatingMajorVersionAndTFM.md
+++ b/docs/UpdatingMajorVersionAndTFM.md
@@ -47,7 +47,11 @@ Once dotnet/runtime has updated their TFM, we update ours in the dependency upda
     * Do not merge this until the PR from the previous step is merged.
 * Update template precedence
   1. Create & merge a PR like [this one](https://github.com/dotnet/spa-templates/pull/39) in dotnet/spa-templates updating `precedence` and `identity` elements in all template.json files.
+      * Going forward, update precedence values by increasing them to the next integer value whose first digits correspond with the major version. This makes it easier to verify that precedence values for any given template were updated since the previous release.
+        * For example, if a precedence value was 9000 for 7.0, increase it to 80000 for 8.0.
   2. Create a PR like [this one](https://github.com/dotnet/aspnetcore/pull/39783) in dotnet/aspnetcore that updates the spa-templates submodule, and updates the `precedence`, `identity`, and (if it exists) `thirdPartyNotices` elements in all template.json files.
+      * Make sure to update _all_ template.json files, including project templates and item templates.
+      * Update precedence values by increasing them to the next integer value whose first digits correspond with the major version.
   3. Make sure the new aka.ms link you're referencing in `thirdPartyNotices` exists.
 * In [src/Framework/AspNetCoreAnalyzers/test/Verifiers/CSharpRouteHandlerCodeFixVerifier.cs](/src/Framework/AspNetCoreAnalyzers/test/Verifiers/CSharpRouteHandlerCodeFixVerifier.cs), update the references to `ReferenceAssemblies.Net.Netx0` with the latest version.