From 41b65a8943ab81c2da7846696e4323bf33197cbd Mon Sep 17 00:00:00 2001
From: Jan Calanog <jan.calanog@elastic.co>
Date: Thu, 2 Apr 2026 10:57:06 +0200
Subject: [PATCH 1/2] HTML: Omit version meta tags for versionless pages

Versionless pages (serverless, cloud, etc.) were rendering the sentinel
value 99999.0+ in product_version and DC.identifier meta tags. Now these
tags are omitted entirely when the page's versioning system is versionless.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/Elastic.Codex/Page/Index.cshtml         | 7 +++++--
 src/Elastic.Markdown/HtmlWriter.cs          | 4 +++-
 src/Elastic.Markdown/Page/Index.cshtml      | 7 +++++--
 src/Elastic.Markdown/Page/IndexViewModel.cs | 2 +-
 4 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/src/Elastic.Codex/Page/Index.cshtml b/src/Elastic.Codex/Page/Index.cshtml
index 258db5b7ab..a7f1f08d7e 100644
--- a/src/Elastic.Codex/Page/Index.cshtml
+++ b/src/Elastic.Codex/Page/Index.cshtml
@@ -84,8 +84,11 @@
 	{
 		if (name == GlobalSections.Head)
 		{
-			<meta class="elastic" name="product_version" content="@(new HtmlString(Model.CurrentVersion))"/>
-			<meta name="DC.identifier" content="@(new HtmlString(Model.CurrentVersion))"/>
+			@if (Model.CurrentVersion is not null)
+			{
+				<meta class="elastic" name="product_version" content="@(new HtmlString(Model.CurrentVersion))"/>
+				<meta name="DC.identifier" content="@(new HtmlString(Model.CurrentVersion))"/>
+			}
 			<link rel="alternate" type="text/markdown" href="@(Model.MarkdownUrl)" title="Markdown export"/>
 			<script type="application/ld+json">
 	    	@(new HtmlString(Model.StructuredBreadcrumbsJson))
diff --git a/src/Elastic.Markdown/HtmlWriter.cs b/src/Elastic.Markdown/HtmlWriter.cs
index 51cea196f5..f65dfe6860 100644
--- a/src/Elastic.Markdown/HtmlWriter.cs
+++ b/src/Elastic.Markdown/HtmlWriter.cs
@@ -117,7 +117,9 @@ private async Task<RenderResult> RenderLayout(MarkdownFile markdown, MarkdownDoc
 			?? throw new InvalidOperationException($"No versioning system available for page '{markdown.RelativePath}'. " +
 				"Ensure VersionsConfiguration contains a Stack versioning system or the inferred product has a VersioningSystem defined.");
 
-		var currentBaseVersion = $"{pageVersioning.Base.Major}.{pageVersioning.Base.Minor}+";
+		var currentBaseVersion = pageVersioning.IsVersionless
+			? null
+			: $"{pageVersioning.Base.Major}.{pageVersioning.Base.Minor}+";
 
 		//TODO should we even distinctby
 		var breadcrumbs = parents.Reverse().DistinctBy(p => p.Url).ToArray();
diff --git a/src/Elastic.Markdown/Page/Index.cshtml b/src/Elastic.Markdown/Page/Index.cshtml
index b67112bf99..c73cdb6f55 100644
--- a/src/Elastic.Markdown/Page/Index.cshtml
+++ b/src/Elastic.Markdown/Page/Index.cshtml
@@ -67,8 +67,11 @@
 	{
 		if (name == GlobalSections.Head)
 		{
-			<meta class="elastic" name="product_version" content="@(new HtmlString(Model.CurrentVersion))"/>
-			<meta name="DC.identifier" content="@(new HtmlString(Model.CurrentVersion))"/>
+			@if (Model.CurrentVersion is not null)
+			{
+				<meta class="elastic" name="product_version" content="@(new HtmlString(Model.CurrentVersion))"/>
+				<meta name="DC.identifier" content="@(new HtmlString(Model.CurrentVersion))"/>
+			}
 			<link rel="alternate" type="text/markdown" href="@(Model.MarkdownUrl)" title="Markdown export"/>
 			<script type="application/ld+json">
 	    	@(new HtmlString(Model.StructuredBreadcrumbsJson))
diff --git a/src/Elastic.Markdown/Page/IndexViewModel.cs b/src/Elastic.Markdown/Page/IndexViewModel.cs
index 13e116b0e5..7bdc3591ca 100644
--- a/src/Elastic.Markdown/Page/IndexViewModel.cs
+++ b/src/Elastic.Markdown/Page/IndexViewModel.cs
@@ -36,7 +36,7 @@ public class IndexViewModel
 
 	public required string NavigationHtml { get; init; }
 
-	public required string CurrentVersion { get; init; }
+	public string? CurrentVersion { get; init; }
 
 	public required string? AllVersionsUrl { get; init; }
 	public required LegacyPageMapping[]? LegacyPages { get; init; }

From 241aa5b29524f9fb3488a6dc800e4f47420a9a8b Mon Sep 17 00:00:00 2001
From: Jan Calanog <jan.calanog@elastic.co>
Date: Thu, 2 Apr 2026 11:08:51 +0200
Subject: [PATCH 2/2] HTML: Restore required modifier on CurrentVersion
 property

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/Elastic.Markdown/Page/IndexViewModel.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Elastic.Markdown/Page/IndexViewModel.cs b/src/Elastic.Markdown/Page/IndexViewModel.cs
index 7bdc3591ca..f64968f5e1 100644
--- a/src/Elastic.Markdown/Page/IndexViewModel.cs
+++ b/src/Elastic.Markdown/Page/IndexViewModel.cs
@@ -36,7 +36,7 @@ public class IndexViewModel
 
 	public required string NavigationHtml { get; init; }
 
-	public string? CurrentVersion { get; init; }
+	public required string? CurrentVersion { get; init; }
 
 	public required string? AllVersionsUrl { get; init; }
 	public required LegacyPageMapping[]? LegacyPages { get; init; }