Wire up page: cross-link resolution in V2 nav

Add PageCrossLinkLeaf — resolves a page: URI to a canonical URL using
sitePrefix + URI host + path (minus .md extension). Renders as a real
clickable link via the existing ILeafNavigationItem branch in the Razor
partial, distinct from PlaceholderNavigationLeaf (disabled).

Also wires page: candidates into the "Ingest or migrate" section of
navigation-v2.yml, replacing title: placeholders where content exists.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: theletterf

config/navigation-v2.yml

@@ -164,42 +164,56 @@ nav:
       children:
       - group: "Ingest or migrate: bring your data into Elasticsearch"
         children:
-        - title: Choose/Plan your ingest method
-        - title: Ingest architectures
+        - page: docs-content://manage-data/ingest.md
+          title: Choose/Plan your ingest method
+        - page: docs-content://manage-data/ingest/ingest-reference-architectures.md
+          title: Ingest architectures
         - group: Ingest by solution (New - Crosslinks)
           children:
-          - title: Ingesting data for search use cases
+          - page: docs-content://solutions/search/ingest-for-search.md
+            title: Ingesting data for search use cases
           - title: Ingesting data for observability (New)
-          - title: Ingesting data for security (Move from Solutions)
-        - title: Ingesting time series data
+          - page: docs-content://solutions/security/get-started/ingest-data-to-elastic-security.md
+            title: Ingesting data for security (Move from Solutions)
+        - page: docs-content://manage-data/ingest/ingesting-timeseries-data.md
+          title: Ingesting time series data
         - title: Logs (Solutions / Obs)
         - group: Ingest data from applications (New)
           children:
-          - title: Collect application data (Solutions / Obs)
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications.md
+            title: Collect application data (Solutions / Obs)
           - title: APM agents
-          - title: Ingest data with Node.js
-          - title: Ingest data with Python
-          - title: Ingest data from Beats with Logstash as a proxy
-          - title: Ingest data from a relational database
-          - title: Ingest logs from a Python application using Filebeat
-          - title: Ingest logs from a Node.js web application using Filebeat
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-data-with-nodejs-on-elasticsearch-service.md
+            title: Ingest data with Node.js
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-data-with-python-on-elasticsearch-service.md
+            title: Ingest data with Python
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-data-from-beats-to-elasticsearch-service-with-logstash-as-proxy.md
+            title: Ingest data from Beats with Logstash as a proxy
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-data-from-relational-database-into-elasticsearch-service.md
+            title: Ingest data from a relational database
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-logs-from-python-application-using-filebeat.md
+            title: Ingest logs from a Python application using Filebeat
+          - page: docs-content://manage-data/ingest/ingesting-data-from-applications/ingest-logs-from-nodejs-web-application-using-filebeat.md
+            title: Ingest logs from a Node.js web application using Filebeat
         - title: Ingest data using the API (New)
-        - title: Upload data files
-        - title: Sample data
+        - page: docs-content://manage-data/ingest/upload-data-files.md
+          title: Upload data files
+        - page: docs-content://manage-data/ingest/sample-data.md
+          title: Sample data
         - title: Migrating your Elasticsearch data
         - group: Ingest tools (from Reference)
           children:
-          - title: Fleet and Elastic Agent
-          - title: Elastic Distributions of OpenTelemetry (EDOT)
-          - title: Elastic Integrations
-          - title: Content connectors
-          - title: Logstash
-          - title: APM
-          - title: Beats
+          - toc: docs-content://reference/fleet
+          - toc: opentelemetry://reference
+          - toc: integration-docs://reference
+          - toc: elasticsearch://reference/search-connectors
+          - toc: logstash://reference
+          - toc: docs-content://reference/apm
+          - toc: beats://reference
           - group: Other ingest tools
             children:
-            - title: Elasticsearch for Apache Hadoop
-            - title: Elastic Serverless Forwarder for AWS
+            - toc: elasticsearch-hadoop://reference
+            - toc: elastic-serverless-forwarder://reference
       - group: Data storage and lifecycle
         children:
         - group: The Elasticsearch data store

src/Elastic.Documentation.Navigation/V2/PageCrossLinkLeaf.cs

@@ -0,0 +1,51 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+namespace Elastic.Documentation.Navigation.V2;
+
+/// <summary>
+/// A real cross-link leaf in the V2 sidebar — has a URL derived from the source
+/// <c>page:</c> URI and the site prefix. Renders as a normal clickable link.
+/// </summary>
+public class PageCrossLinkLeaf(
+	Uri page,
+	string title,
+	string sitePrefix,
+	INodeNavigationItem<INavigationModel, INavigationItem>? parent
+) : ILeafNavigationItem<INavigationModel>, INavigationModel
+{
+	/// <inheritdoc />
+	public INavigationModel Model => this;
+
+	/// <inheritdoc />
+	public string Url { get; } = ResolveUrl(page, sitePrefix);
+
+	/// <inheritdoc />
+	public string NavigationTitle { get; } = title;
+
+	/// <inheritdoc />
+	public IRootNavigationItem<INavigationModel, INavigationItem> NavigationRoot { get; } = parent?.NavigationRoot!;
+
+	/// <inheritdoc />
+	public INodeNavigationItem<INavigationModel, INavigationItem>? Parent { get; set; } = parent;
+
+	/// <inheritdoc />
+	public bool Hidden => false;
+
+	/// <inheritdoc />
+	public int NavigationIndex { get; set; }
+
+	private static string ResolveUrl(Uri page, string sitePrefix)
+	{
+		// URI host carries the first path segment (e.g. docs-content://manage-data/ingest.md
+		// → host="manage-data", absolutePath="/ingest.md"), so combine both.
+		var path = (page.Host + page.AbsolutePath).Trim('/');
+		if (path.EndsWith(".md", StringComparison.OrdinalIgnoreCase))
+			path = path[..^3];
+		if (path.EndsWith("/index", StringComparison.OrdinalIgnoreCase))
+			path = path[..^6];
+		var prefix = "/" + sitePrefix.Trim('/');
+		return string.IsNullOrEmpty(path) ? prefix : $"{prefix}/{path}";
+	}
+}

src/Elastic.Documentation.Navigation/V2/SiteNavigationV2.cs

@@ -25,23 +25,24 @@ public SiteNavigationV2(
 		IReadOnlyCollection<IDocumentationSetNavigation> documentationSetNavigations,
 		string? sitePrefix
 	) : base(originalFile, context, documentationSetNavigations, sitePrefix)
-		=> V2NavigationItems = BuildV2Items(v2File.Nav, Nodes, this, depth: 0);
+		=> V2NavigationItems = BuildV2Items(v2File.Nav, Nodes, this, depth: 0, sitePrefix: sitePrefix ?? string.Empty);
 
 	/// <summary>
 	/// Label-structured navigation items for V2 sidebar rendering.
 	/// Contains <see cref="LabelNavigationNode"/>, <see cref="PlaceholderNavigationLeaf"/>,
-	/// and existing <see cref="IRootNavigationItem{TIndex,TChildNavigation}"/> nodes.
+	/// <see cref="PageCrossLinkLeaf"/>, and existing <see cref="IRootNavigationItem{TIndex,TChildNavigation}"/> nodes.
 	/// </summary>
 	public IReadOnlyList<INavigationItem> V2NavigationItems { get; }
 
 	private static IReadOnlyList<INavigationItem> BuildV2Items(
 		IReadOnlyList<INavV2Item> v2Items,
 		IReadOnlyDictionary<Uri, IRootNavigationItem<IDocumentationFile, INavigationItem>> nodes,
 		INodeNavigationItem<INavigationModel, INavigationItem> parent,
-		int depth
+		int depth,
+		string sitePrefix
 	) =>
 		v2Items
-			.Select(item => CreateV2NavigationItem(item, nodes, parent, depth))
+			.Select(item => CreateV2NavigationItem(item, nodes, parent, depth, sitePrefix))
 			.Where(navItem => navItem is not null)
 			.Cast<INavigationItem>()
 			.ToList();
@@ -50,40 +51,42 @@ int depth
 		INavV2Item item,
 		IReadOnlyDictionary<Uri, IRootNavigationItem<IDocumentationFile, INavigationItem>> nodes,
 		INodeNavigationItem<INavigationModel, INavigationItem> parent,
-		int depth
+		int depth,
+		string sitePrefix
 	) =>
 		item switch
 		{
-			LabelNavV2Item label => CreateLabel(label, nodes, parent, depth),
-			GroupNavV2Item group => CreateGroup(group, nodes, parent, depth),
+			LabelNavV2Item label => CreateLabel(label, nodes, parent, depth, sitePrefix),
+			GroupNavV2Item group => CreateGroup(group, nodes, parent, depth, sitePrefix),
 			TocNavV2Item toc => nodes.TryGetValue(toc.Source, out var node) ? node : null,
 			PageNavV2Item { Page: null, Title: var title } => new PlaceholderNavigationLeaf(title ?? "Untitled", parent),
-			PageNavV2Item { Title: var title } page => new PlaceholderNavigationLeaf(title ?? page.Page?.ToString() ?? "Unknown", parent),
+			PageNavV2Item { Page: var page, Title: var title } => new PageCrossLinkLeaf(page!, title ?? page!.ToString(), sitePrefix, parent),
 			_ => null
 		};
 
 	private static LabelNavigationNode CreateLabel(
 		LabelNavV2Item label,
 		IReadOnlyDictionary<Uri, IRootNavigationItem<IDocumentationFile, INavigationItem>> nodes,
 		INodeNavigationItem<INavigationModel, INavigationItem> parent,
-		int depth
+		int depth,
+		string sitePrefix
 	)
 	{
-		// Build a temporary label so it can be used as parent for its children
 		var placeholder = new LabelNavigationNode(label.Label, label.Expanded, [], parent);
-		var children = BuildV2Items(label.Children, nodes, placeholder, depth + 1);
+		var children = BuildV2Items(label.Children, nodes, placeholder, depth + 1, sitePrefix);
 		return new LabelNavigationNode(label.Label, label.Expanded, children, parent);
 	}
 
 	private static PlaceholderNavigationNode CreateGroup(
 		GroupNavV2Item group,
 		IReadOnlyDictionary<Uri, IRootNavigationItem<IDocumentationFile, INavigationItem>> nodes,
 		INodeNavigationItem<INavigationModel, INavigationItem> parent,
-		int depth
+		int depth,
+		string sitePrefix
 	)
 	{
 		var placeholder = new PlaceholderNavigationNode(group.Title, [], parent);
-		var children = BuildV2Items(group.Children, nodes, placeholder, depth + 1);
+		var children = BuildV2Items(group.Children, nodes, placeholder, depth + 1, sitePrefix);
 		return new PlaceholderNavigationNode(group.Title, children, parent);
 	}
 }