From 6e6fe9d5ae01022c4e39e82f60e9cfb390055150 Mon Sep 17 00:00:00 2001
From: Luke Latham <1622880+guardrex@users.noreply.github.com>
Date: Wed, 13 Nov 2024 13:14:07 -0500
Subject: [PATCH] Add a not-latest-version INCLUDE (#34108)

---
 ...t-version-without-not-supported-content.md | 29 +++++++++++++++++++
 aspnetcore/includes/not-latest-version.md     | 17 +++++++++--
 2 files changed, 43 insertions(+), 3 deletions(-)
 create mode 100644 aspnetcore/includes/not-latest-version-without-not-supported-content.md

diff --git a/aspnetcore/includes/not-latest-version-without-not-supported-content.md b/aspnetcore/includes/not-latest-version-without-not-supported-content.md
new file mode 100644
index 0000000000..a7f3e4d4a3
--- /dev/null
+++ b/aspnetcore/includes/not-latest-version-without-not-supported-content.md
@@ -0,0 +1,29 @@
+:::moniker range="< aspnetcore-9.0"
+> [!NOTE]
+> This isn't the latest version of this article. For the current release, see the [.NET 9 version of this article](?view=aspnetcore-9.0&preserve-view=true).
+:::moniker-end
+
+:::moniker range="> aspnetcore-9.0"
+> [!IMPORTANT]
+> This information relates to a pre-release product that may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
+>
+> For the current release, see the [.NET 9 version of this article](?view=aspnetcore-9.0&preserve-view=true).
+:::moniker-end
+
+<!--
+Include either this file or 'not-latest-version.md' at the top of articles.
+
+'not-latest-version.md': Includes not-supported content.
+'not-latest-version-without-not-supported-content.md' (this file): Doesn't include not-supported content.
+
+Use this file in articles that target >=8.0 until 9.0 reaches EOL, and then update those
+articles to use 'not-latest-version.md'. For articles that target >=7.0, 'not-latest-version.md'
+can be used without creating a zone/file moniker range mismatch error.
+
+When a new version is released, it might be necessary to temporarily comment out the current version
+moniker range section until the new moniker is created.
+
+Markdown to include this file:
+
+[!INCLUDE[](~/includes/not-latest-version-without-not-supported-content.md)]
+-->
diff --git a/aspnetcore/includes/not-latest-version.md b/aspnetcore/includes/not-latest-version.md
index ca1f12faf3..1eccb5a2b6 100644
--- a/aspnetcore/includes/not-latest-version.md
+++ b/aspnetcore/includes/not-latest-version.md
@@ -15,9 +15,20 @@
 :::moniker-end
 
 <!--
-Include this file at the top of articles. When a new version is released,
-it might be necessary to temporarily comment out the  current version
-moniker range section until the new moniker is created.
+Include either this file or 'not-latest-version-without-not-supported-content.md' at the top 
+of articles.
+
+'not-latest-version.md' (this file): Includes not-supported content.
+'not-latest-version-without-not-supported-content.md': Doesn't include not-supported content.
+
+Use this file in articles that target >=7.0. For articles that target >=8.0 prior to 9.0
+reaching EOL, 'not-latest-version-without-not-supported-content.md' must be used to avoid
+a zone/file moniker range mismatch error.
+
+When a new version is released, it might be necessary to temporarily comment out the current 
+version moniker range section until the new moniker is created.
+
 Markdown to include this file:
+
 [!INCLUDE[](~/includes/not-latest-version.md)]
 -->