Fix documentation generation

AndreyAkinshin · AndreyAkinshin · commit f43495c165c6 · 2023-07-08T04:12:11.000+02:00
diff --git a/build/BenchmarkDotNet.Build/ChangeLogBuilder.cs b/build/BenchmarkDotNet.Build/ChangeLogBuilder.cs
@@ -136,11 +136,11 @@ string PresentContributor(GitHubCommit commit)
                 .Distinct()
                 .ToImmutableList();
 
-            var milestoneHtmlUlr = $"https://github.com/{Repo.Owner}/{Repo.Name}/issues?q=milestone:{currentVersion}";
+            var milestoneHtmlUlr = $"https://github.com/{Repo.Owner}/{Repo.Name}/issues?q=milestone:v{currentVersion}";
 
             builder.AppendLine("## Milestone details");
             builder.AppendLine();
-            builder.AppendLine($"In the [{currentVersion}]({milestoneHtmlUlr}) scope, ");
+            builder.AppendLine($"In the [v{currentVersion}]({milestoneHtmlUlr}) scope, ");
             builder.Append(issues.Count + " issues were resolved and ");
             builder.AppendLine(pullRequests.Count + " pull requests were merged.");
             builder.AppendLine($"This release includes {commits.Count} commits by {contributors.Count} contributors.");
diff --git a/build/BenchmarkDotNet.Build/Runners/DocumentationRunner.cs b/build/BenchmarkDotNet.Build/Runners/DocumentationRunner.cs
@@ -133,13 +133,13 @@ private void GenerateChangelogToc()
     {
         var content = new StringBuilder();
 
-        content.AppendLine($"- name: {context.VersionHistory.CurrentVersion}");
-        content.AppendLine($"  href: {context.VersionHistory.CurrentVersion}.md");
+        content.AppendLine($"- name: v{context.VersionHistory.CurrentVersion}");
+        content.AppendLine($"  href: v{context.VersionHistory.CurrentVersion}.md");
         
         foreach (var version in context.VersionHistory.StableVersions.Reverse())
         {
-            content.AppendLine($"- name: {version}");
-            content.AppendLine($"  href: {version}.md");
+            content.AppendLine($"- name: v{version}");
+            content.AppendLine($"  href: v{version}.md");
         }
 
         content.AppendLine("- name: Full ChangeLog");
@@ -158,9 +158,9 @@ private void GenerateChangelogFull()
         content.AppendLine("# Full ChangeLog");
         content.AppendLine("");
         content.AppendLine(
-            $"[!include[{context.VersionHistory.CurrentVersion}]({context.VersionHistory.CurrentVersion}.md)]");
+            $"[!include[v{context.VersionHistory.CurrentVersion}](v{context.VersionHistory.CurrentVersion}.md)]");
         foreach (var version in context.VersionHistory.StableVersions.Reverse())
-            content.AppendLine($"[!include[{version}]({version}.md)]");
+            content.AppendLine($"[!include[v{version}](v{version}.md)]");
 
         context.GenerateFile(changelogFullFile, content);
     }
@@ -174,9 +174,9 @@ private void GenerateChangelogIndex()
         content.AppendLine("");
         content.AppendLine("# ChangeLog");
         content.AppendLine("");
-        content.AppendLine($"* @changelog.{context.VersionHistory.CurrentVersion}");
+        content.AppendLine($"* @changelog.v{context.VersionHistory.CurrentVersion}");
         foreach (var version in context.VersionHistory.StableVersions.Reverse())
-            content.AppendLine($"* @changelog.{version}");
+            content.AppendLine($"* @changelog.v{version}");
         content.AppendLine("* @changelog.full");
 
         context.GenerateFile(changelogIndexFile, content);
@@ -185,17 +185,18 @@ private void GenerateChangelogIndex()
     private void DocfxChangelogGenerate(string version)
     {
         EnsureChangelogDetailsExist();
-        var header = ChangelogSrcDirectory.Combine("header").CombineWithFilePath(version + ".md");
-        var footer = ChangelogSrcDirectory.Combine("footer").CombineWithFilePath(version + ".md");
-        var details = ChangelogSrcDirectory.Combine("details").CombineWithFilePath(version + ".md");
-        var release = ChangelogDirectory.CombineWithFilePath(version + ".md");
+        var md = $"v{version}.md";
+        var header = ChangelogSrcDirectory.Combine("header").CombineWithFilePath(md);
+        var footer = ChangelogSrcDirectory.Combine("footer").CombineWithFilePath(md);
+        var details = ChangelogSrcDirectory.Combine("details").CombineWithFilePath(md);
+        var release = ChangelogDirectory.CombineWithFilePath(md);
 
         var content = new StringBuilder();
         content.AppendLine("---");
-        content.AppendLine("uid: changelog." + version);
+        content.AppendLine("uid: changelog.v" + version);
         content.AppendLine("---");
         content.AppendLine("");
-        content.AppendLine("# BenchmarkDotNet " + version);
+        content.AppendLine("# BenchmarkDotNet v" + version);
         content.AppendLine("");
         content.AppendLine("");
 
diff --git a/docs/template/public/main.css b/docs/template/public/main.css
@@ -5,4 +5,8 @@
 
 #breadcrumb {
   display: none;
+}
+
+.affix {
+  display: none !important;
 }

Original file line number	Diff line number	Diff line change
`@@ -5,4 +5,8 @@`
`5`	`5`
`6`	`6`	`#breadcrumb {`
`7`	`7`	`display: none;`
	`8`	`+}`
	`9`	`+`
	`10`	`+.affix {`
	`11`	`+ display: none !important;`
`8`	`12`	`}`