fix: remove dev badge; fix RTD latest version identifier to develop

README.md:
- Remove the dev PyPI badge (include_prereleases=true never reliably worked)
- Keep only the stable badge which correctly shows v0.2.3

dev-release.yml:
- Add Step 2: PATCH /versions/latest/ with identifier='develop'
  This is the actual root cause — the version object has its own branch
  setting separate from the project-level default_branch
- Numbered steps [1/3], [2/3], [3/3] for clarity in logs

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: tbitcs

.github/workflows/dev-release.yml

@@ -106,18 +106,29 @@ jobs:
             echo "  Fix: https://readthedocs.org/projects/specsmith/versions/ → activate 'develop'"
           fi
 
-          # Set RTD default branch to 'develop' so /en/latest/ always tracks dev builds.
-          # This is idempotent — safe to run on every push to develop.
-          echo "Setting RTD default branch to 'develop'..."
+          # Step 1: Set RTD project default_branch to 'develop'
+          echo "[1/3] Setting RTD project default_branch to 'develop'..."
           PATCH_STATUS=$(curl -s -o /dev/null -w "%{http_code}" -X PATCH \
             -H "Authorization: Token $RTD_TOKEN" \
             -H "Content-Type: application/json" \
             -d '{"default_branch": "develop"}' \
             "https://readthedocs.org/api/v3/projects/specsmith/")
-          echo "RTD default_branch PATCH: HTTP $PATCH_STATUS"
+          echo "RTD project PATCH: HTTP $PATCH_STATUS"
 
-          # Trigger /en/latest/ build (tracks default branch = develop after above PATCH)
-          echo "Triggering RTD build for 'latest' version..."
+          # Step 2: Set the 'latest' VERSION object's identifier to 'develop'
+          # This is the key step — the version object has its own branch setting
+          # separate from the project-level default_branch.
+          echo "[2/3] Setting RTD 'latest' version identifier to 'develop'..."
+          VER_PATCH=$(curl -s -o /tmp/ver_patch.txt -w "%{http_code}" -X PATCH \
+            -H "Authorization: Token $RTD_TOKEN" \
+            -H "Content-Type: application/json" \
+            -d '{"identifier": "develop", "active": true}' \
+            "https://readthedocs.org/api/v3/projects/specsmith/versions/latest/")
+          echo "RTD 'latest' version PATCH: HTTP $VER_PATCH"
+          cat /tmp/ver_patch.txt | head -c 200 || true
+
+          # Step 3: Trigger a fresh /en/latest/ build (now tracks develop)
+          echo "[3/3] Triggering RTD 'latest' build from develop..."
           LATEST_STATUS=$(curl -s -o /dev/null -w "%{http_code}" -X POST \
             -H "Authorization: Token $RTD_TOKEN" \
             "https://readthedocs.org/api/v3/projects/specsmith/versions/latest/builds/")

README.md

@@ -2,8 +2,7 @@
 
 [![CI](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml/badge.svg)](https://github.com/BitConcepts/specsmith/actions/workflows/ci.yml)
 [![Docs](https://readthedocs.org/projects/specsmith/badge/?version=stable)](https://specsmith.readthedocs.io/en/stable/)
-[![PyPI Stable](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
-[![PyPI Dev](https://img.shields.io/pypi/v/specsmith?include_prereleases=true&label=dev&style=flat&color=orange&cacheSeconds=60)](https://pypi.org/project/specsmith/#history)
+[![PyPI](https://img.shields.io/pypi/v/specsmith?label=stable&style=flat&color=blue&cacheSeconds=60)](https://pypi.org/project/specsmith/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)