From 643820eaf8b6a05bf46289dd07059aa2680d7d31 Mon Sep 17 00:00:00 2001
From: Kieran Didi
 <kdidi@slurm-login-0.slurm-login.tenant-slurm.svc.cluster.local>
Date: Fri, 17 Jul 2026 18:43:19 +0000
Subject: [PATCH 1/2] Docs: point version switcher at RosettaCommons Pages

Keep future release switchers on the repository's current Pages host instead of the retired atomworks-dev URL.
---
 .github/workflows/release_and_docs.yaml | 4 ++--
 docs/conf.py                            | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/release_and_docs.yaml b/.github/workflows/release_and_docs.yaml
index ba67708e..1aadea79 100644
--- a/.github/workflows/release_and_docs.yaml
+++ b/.github/workflows/release_and_docs.yaml
@@ -117,7 +117,7 @@ jobs:
               fi
               
               if [[ "$v" == "latest" ]]; then
-                entry="{\"version\": \"latest\", \"url\": \"https://baker-laboratory.github.io/atomworks-dev/latest/index.html\", \"name\": \"latest\"}"
+                entry="{\"version\": \"latest\", \"url\": \"https://rosettacommons.github.io/atomworks/latest/index.html\", \"name\": \"latest\"}"
               else
                 disp="${v#v}"
                 # Mark the newest stable version as preferred
@@ -126,7 +126,7 @@ jobs:
                 else
                   preferred="false"
                 fi
-                entry="{\"version\": \"$disp\", \"url\": \"https://baker-laboratory.github.io/atomworks-dev/$v/index.html\", \"name\": \"v$disp\", \"preferred\": $preferred}"
+                entry="{\"version\": \"$disp\", \"url\": \"https://rosettacommons.github.io/atomworks/$v/index.html\", \"name\": \"v$disp\", \"preferred\": $preferred}"
               fi
               
               switcher_content="$switcher_content$entry"
diff --git a/docs/conf.py b/docs/conf.py
index 358c8db6..0b21f922 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -71,7 +71,7 @@
     },
     "navbar_start": ["navbar-logo", "version-switcher"],
     "switcher": {
-        "json_url": "https://baker-laboratory.github.io/atomworks-dev/latest/_static/switcher.json",
+        "json_url": "https://rosettacommons.github.io/atomworks/latest/_static/switcher.json",
         "version_match": switcher_version,
     },
     "favicons": [

From bc437fd595c57ce5b55c4e33fea345027db1eb78 Mon Sep 17 00:00:00 2001
From: Kieran Didi
 <kdidi@slurm-login-0.slurm-login.tenant-slurm.svc.cluster.local>
Date: Fri, 17 Jul 2026 18:45:26 +0000
Subject: [PATCH 2/2] Docs: deploy archived docs only for tagged releases

Prevent non-release production pushes from overwriting the latest immutable version directory.
---
 .github/workflows/release_and_docs.yaml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/release_and_docs.yaml b/.github/workflows/release_and_docs.yaml
index 1aadea79..98ea0cf7 100644
--- a/.github/workflows/release_and_docs.yaml
+++ b/.github/workflows/release_and_docs.yaml
@@ -56,7 +56,10 @@ jobs:
           PYPI_REPO_URL: https://upload.pypi.org/legacy/
         run: |
           npx semantic-release
-          VERSION=$(git describe --tags --abbrev=0 --match "v*" 2>/dev/null || echo "no-version")
+          # Only publish docs when semantic-release tagged this exact commit.
+          # Using the newest historical tag here would overwrite immutable
+          # version docs after a non-release production push.
+          VERSION=$(git describe --tags --exact-match --match "v*" HEAD 2>/dev/null || echo "no-version")
           echo "version=$VERSION" >> $GITHUB_OUTPUT
           echo "Released version: $VERSION"