From 4c2d45599f4768126882fb2451017faa459330a3 Mon Sep 17 00:00:00 2001 From: Julien Truffaut Date: Fri, 4 Sep 2026 15:44:15 +0200 Subject: [PATCH] Pin docusaurusVersion to V1 so the website deploy works again The website publish has failed since sbt-mdoc was bumped from 2.4.0 to 2.9.0 in April, with: error Command "deploy" not found. 2.4.0 hardcoded `USE_SSH=true yarn publish-gh-pages`. 2.9.0 introduced a docusaurusVersion setting that defaults to V3, whose publish step runs `yarn deploy` instead. website/ is still Docusaurus 1 -- siteConfig.js, sidebars.json, no docusaurus.config.js -- and its package.json defines publish-gh-pages, not deploy. Declaring V1 restores `USE_SSH=true yarn publish-gh-pages`, matching what 2.4.0 ran. The deploy key was never the problem; ssh authenticated fine in the failing runs. Verified by building the site end to end with docs/docusaurusCreateSite: mdoc, yarn install and the Docusaurus 1 build all succeed, producing 248 html files. Migrating the site to Docusaurus 3 is the longer-term fix and is left alone here. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01QRbVCYWp3bquNaXPYW12JY --- build.sbt | 1 + 1 file changed, 1 insertion(+) diff --git a/build.sbt b/build.sbt index 21e789c2a..43ec110aa 100644 --- a/build.sbt +++ b/build.sbt @@ -350,6 +350,7 @@ lazy val docs = project .settings(buildInfoSettings) .settings(scalacOptions ~= (_.filterNot(Set("-Ywarn-unused:imports", "-Ywarn-dead-code")))) .settings( + docusaurusVersion := DocusaurusVersion.V1, libraryDependencies ++= Seq(cats.value, shapeless.value) )