Merge pull request #316 from armanbilge/doc/auto-populate-startyear-sjsv

Auto-populate startYear and SJS version in docs

Author: armanbilge

build.sbt

@@ -198,5 +198,28 @@ lazy val docs = project
       "mdoc" -> url("https://scalameta.org/mdoc/"),
       "Laika" -> url("https://planet42.github.io/Laika/"),
       "sbt-unidoc" -> url("https://github.com/sbt/sbt-unidoc")
-    )
+    ),
+    mdocVariables ++= {
+      import coursier.complete.Complete
+      import java.time._
+      import scala.concurrent._
+      import scala.concurrent.duration._
+      import scala.concurrent.ExecutionContext.Implicits._
+
+      val startYear = YearMonth.now().getYear.toString
+
+      val sjsVersionFuture =
+        Complete().withInput(s"org.scala-js:scalajs-library_2.13:").complete().future()
+      val sjsVersion =
+        try {
+          Await.result(sjsVersionFuture, 5.seconds)._2.last
+        } catch {
+          case ex: TimeoutException => scalaJSVersion // not the latest but better than nothing
+        }
+
+      Map(
+        "START_YEAR" -> startYear,
+        "LATEST_SJS_VERSION" -> sjsVersion
+      )
+    }
   )

docs/faq.md

@@ -101,7 +101,7 @@ Check out the [**sbt-typelevel-site**](site.md) plugin.
 We recommend explicitly setting your Scala.js version in `project/plugins.sbt`.
 
 ```scala
-addSbtPlugin("org.scala-js" % "sbt-scalajs" % "1.10.0")
+addSbtPlugin("org.scala-js" % "sbt-scalajs" % "@LATEST_SJS_VERSION@")
 ```
 
 **sbt-typelevel** ships with a conservative Scala.js version to enable certain settings.

docs/index.md

@@ -71,7 +71,7 @@ ThisBuild / tlBaseVersion := "0.4" // your current series x.y
 
 ThisBuild / organization := "org.typelevel"
 ThisBuild / organizationName := "Typelevel"
-ThisBuild / startYear := Some(2022)
+ThisBuild / startYear := Some(@START_YEAR@)
 ThisBuild / licenses := Seq(License.Apache2)
 ThisBuild / developers := List(
   // your GitHub handle and name

project/build.sbt

@@ -24,3 +24,7 @@ Compile / unmanagedSourceDirectories ++= modules.map { module =>
 Compile / unmanagedResourceDirectories ++= modules.map { module =>
   baseDirectory.value.getParentFile / module / "src" / "main" / "resources"
 }
+
+libraryDependencies ++= Seq(
+  "io.get-coursier" %% "coursier" % "2.1.0-M6"
+)