fix(docs): build v2 docs (#4257)

* fix(docs):  build v2 docs

* ci(docs): do not build v3 anymore

Author: JacobCoffee

.github/workflows/docs.yml

@@ -6,7 +6,7 @@ on:
   push:
     branches:
       - main
-      - v3.0
+      - v2
 
 env:
   UV_LOCKED: 1
@@ -43,9 +43,9 @@ jobs:
         run: uv run python tools/build_docs.py docs-build --version main
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
 
-      - name: Build docs (v3.0 branch)
-        run: uv run python tools/build_docs.py docs-build --version 3-dev
-        if: github.event_name == 'push' && github.ref == 'refs/heads/v3.0'
+      - name: Build docs (v2 branch)
+        run: uv run python tools/build_docs.py docs-build --version 2
+        if: github.event_name == 'push' && github.ref == 'refs/heads/v2'
 
       - name: Deploy
         uses: JamesIves/github-pages-deploy-action@v4

docs/_static/versioning.js

@@ -22,7 +22,7 @@ const addVersionWarning = (currentVersion, latestVersion) => {
   container.id = "version-warning";
 
   const isPreviewVersion = (version) => {
-        const previewVersions = ['dev', 'develop', 'main', '3-dev'];
+        const previewVersions = ['dev', 'develop', 'main'];
         return previewVersions.includes(version) || parseInt(version) > parseInt(latestVersion);
     };
 

docs/_static/versions.json

@@ -1 +1 @@
-{ "versions": ["1", "2", "main", "3-dev"], "latest": "2" }
+{ "versions": ["1", "2", "main"], "latest": "2" }

docs/conf.py

@@ -302,11 +302,10 @@
     "source_user": "litestar-org",
     "source_repo": "litestar",
     # "source_version": "main",  # TODO: We should set this with an envvar depending on which branch we are building?
-    "current_version": "latest",  # TODO: Version dropdown only show caret and now text
+    "current_version": release,  # Use the detected version
     "versions": [  # TODO(provinzkraut): this needs to use versions.json but im not 100% on how to do this yet
         ("latest", "/latest"),
-        ("development", "/main"),
-        ("v3", "/3-dev"),
+        ("v3 (development)", "/main"),
         ("v2", "/2"),
         ("v1", "/1"),
     ],