Added a changelog to the Mill site (#2717)

Pull request: #2717

build.sc

@@ -1447,10 +1447,14 @@ object docs extends Module {
   }
 
   def source0 = T.source(millSourcePath)
+  def projectReadme = T.source(T.workspace / "readme.adoc")
   def source = T {
     os.copy(source0().path, T.dest, mergeFolders = true)
 
     val pagesWd = T.dest / "modules" / "ROOT" / "pages"
+    val partialsWd = T.dest / "modules" / "ROOT" / "partials"
+
+    os.copy(projectReadme().path, partialsWd  / "project-readme.adoc", createFolders = true)
 
     val renderedExamples: Seq[(os.SubPath, PathRef)] =
       T.traverse(example.exampleModules)(m =>
@@ -1568,13 +1572,26 @@ object docs extends Module {
       createFolders = true
     )
     T.log.errorStream.println("Running Antora ...")
-    // check xrefs
+//    // check xrefs
+//    runAntora(
+//      npmDir = npmBase(),
+//      workDir = docSite,
+//      args = Seq(
+//        "--generator",
+//        "@antora/xref-validator",
+//        playbook.last,
+//        "--to-dir",
+//        siteDir.toString(),
+//        "--attribute",
+//        "page-pagination"
+//      ) ++
+//        Seq("--fetch").filter(_ => !authorMode)
+//    )
+    // generate site (we can skip the --fetch now)
     runAntora(
       npmDir = npmBase(),
       workDir = docSite,
       args = Seq(
-        "--generator",
-        "@antora/xref-validator",
         playbook.last,
         "--to-dir",
         siteDir.toString(),
@@ -1583,18 +1600,6 @@ object docs extends Module {
       ) ++
         Seq("--fetch").filter(_ => !authorMode)
     )
-    // generate site (we can skip the --fetch now)
-    runAntora(
-      npmDir = npmBase(),
-      workDir = docSite,
-      args = Seq(
-        playbook.last,
-        "--to-dir",
-        siteDir.toString(),
-        "--attribute",
-        "page-pagination"
-      )
-    )
     os.write(siteDir / ".nojekyll", "")
 
     // sanitize devAntora source URLs

docs/modules/ROOT/nav.adoc

@@ -58,4 +58,4 @@
 * xref:Mill_Design_Principles.adoc[]
 * xref:External_References.adoc[]
 * {mill-doc-url}/api/latest/mill/index.html[Mill Scaladoc]
-
+* xref:Changelog.adoc[]

docs/modules/ROOT/pages/Changelog.adoc

@@ -0,0 +1,4 @@
+// = Changelog
+include::partial$project-readme.adoc[tag=changelog,leveloffset=-1]
+
+include::partial$project-readme.adoc[tag=changelogOld,leveloffset=-1]