Add edge content source

Author: Mpdreamz

config/assembler.yml

@@ -27,11 +27,15 @@ environments:
       LAZY_LOAD_NAVIGATION: true
   dev:
     uri: http://localhost:4000
-    content_source: next
+    content_source: edge
     path_prefix: docs
 
 named_git_references:
-  stack: &stack 9.0
+  stack:
+    current: &stack_current 9.0
+    next: &stack_next 9.1
+    edge: &stack_edge main
+
   cloud-hosted: ms-120
 
 ###
@@ -68,8 +72,9 @@ references:
   apm-aws-lambda:
   apm-k8s-attacher:
   beats:
-    current: "9.0"
-    next: main
+   current: *stack_current
+   next: *stack_next
+   edge: *stack_edge
   ecs-dotnet:
   ecs-logging-go-logrus:
   ecs-logging-go-zap:
@@ -81,8 +86,9 @@ references:
   ecs-logging-ruby:
   ecs-logging:
   ecs:
-    current: "9.0"
-    next: main
+   current: *stack_current
+   next: *stack_next
+   edge: *stack_edge
   elastic-otel-dotnet:
   elastic-otel-java:
   elastic-otel-node:
@@ -93,8 +99,9 @@ references:
   integrations:
   logstash-docs-md:
   logstash:
-    current: "9.0"
-    next: main
+   current: *stack_current
+   next: *stack_next
+   edge: *stack_edge
   opentelemetry:
 
   # @elastic/admin-docs

src/Elastic.Documentation.Configuration/Assembler/AssemblyConfiguration.cs

@@ -55,6 +55,8 @@ private static TRepository RepositoryDefaults<TRepository>(TRepository r, string
 			repository.GitReferenceCurrent = "main";
 		if (string.IsNullOrEmpty(repository.GitReferenceNext))
 			repository.GitReferenceNext = "main";
+		if (string.IsNullOrEmpty(repository.GitReferenceEdge))
+			repository.GitReferenceEdge = "main";
 		if (string.IsNullOrEmpty(repository.Origin))
 		{
 			if (!string.IsNullOrEmpty(Environment.GetEnvironmentVariable("GITHUB_ACTIONS")))

src/Elastic.Documentation.Configuration/Assembler/ContentSource.cs

@@ -17,5 +17,9 @@ public enum ContentSource
 
 	[JsonStringEnumMemberName("current")]
 	[Display(Name = "current")]
-	Current
+	Current,
+
+	[JsonStringEnumMemberName("edge")]
+	[Display(Name = "edge")]
+	Edge
 }

src/Elastic.Documentation.Configuration/Assembler/Repository.cs

@@ -35,6 +35,9 @@ public record Repository
 	[YamlMember(Alias = "next")]
 	public string GitReferenceNext { get; set; } = "main";
 
+	[YamlMember(Alias = "edge")]
+	public string GitReferenceEdge { get; set; } = "main";
+
 	[YamlMember(Alias = "checkout_strategy")]
 	public CheckoutStrategy CheckoutStrategy { get; set; } = CheckoutStrategy.Partial;
 
@@ -45,6 +48,7 @@ public record Repository
 	{
 		ContentSource.Current => GitReferenceCurrent,
 		ContentSource.Next => GitReferenceNext,
+		ContentSource.Edge => GitReferenceEdge,
 		_ => throw new ArgumentException($"The content source {contentSource} is not supported.", nameof(contentSource))
 	};
 }

src/tooling/docs-assembler/Building/AssemblerCrossLinkFetcher.cs

@@ -29,9 +29,7 @@ public override async Task<FetchedCrossLinks> Fetch(Cancel ctx)
 			if (repository.Skip)
 				continue;
 
-			var branch = publishEnvironment.ContentSource == ContentSource.Current
-				? repository.GitReferenceCurrent
-				: repository.GitReferenceNext;
+			var branch = repository.GetBranch(publishEnvironment.ContentSource);
 
 			var linkReference = await Fetch(repositoryName, [branch], ctx);
 			linkReferences.Add(repositoryName, linkReference);

src/tooling/docs-assembler/Navigation/AssemblerDocumentationSet.cs

@@ -30,7 +30,8 @@ public AssemblerDocumentationSet(
 		Checkout checkout,
 		CrossLinkResolver crossLinkResolver,
 		TableOfContentsTreeCollector treeCollector,
-		VersionsConfiguration versionsConfiguration)
+		VersionsConfiguration versionsConfiguration
+	)
 	{
 		AssembleContext = context;
 		Checkout = checkout;
@@ -47,7 +48,7 @@ public AssemblerDocumentationSet(
 			RepositoryName = checkout.Repository.Name,
 			Ref = checkout.HeadReference,
 			Remote = $"elastic/${checkout.Repository.Name}",
-			Branch = checkout.Repository.GitReferenceCurrent
+			Branch = checkout.Repository.GetBranch(env.ContentSource)
 		};
 
 		var buildContext = new BuildContext(

tests/docs-assembler.Tests/src/docs-assembler.Tests/AssemblerConfigurationTests.cs

@@ -70,6 +70,12 @@ public void ReadsVersions()
 			.And.Be("main");
 		apmServer.GitReferenceCurrent.Should().NotBeNullOrEmpty()
 			.And.Be("main");
+		apmServer.GitReferenceEdge.Should().NotBeNullOrEmpty()
+			.And.Be("main");
+
+		var beats = config.ReferenceRepositories["apm-server"];
+		beats.GitReferenceCurrent.Should().NotBeNullOrEmpty()
+			.And.NotBe("main");
 
 	}
 }