fix changelog

Author: Lucia-Poma

CHANGELOG.md

@@ -19,8 +19,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Read the Docs: standard sphinx-rtd-theme palette (dark grey sidebar frame,
   light content panel, default blue links/headings); explicit table/body text
-  contrast on the light panel; screenshots and figures capped at 60% width
-  (centered) via ``docs/_static/custom.css``.
+  contrast on the light panel; browser tab favicon uses the logo on a cream
+  background (``scripts/generate_docs_favicon.py``); screenshots and figures
+  capped at 60% width (centered) via ``docs/_static/custom.css``.
 - Docs screenshot pipeline: wizard captures use 60% of the app's normal step window
   size (``WIZARD_SCREENSHOT_SIZE_RATIO`` in ``tests/docs/screenshot_helpers.py``)
   for denser, balanced full-window PNGs on RTD.
@@ -50,38 +51,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Read the Docs: dark outer page background (matching the sidebar); browser tab
-  favicon uses the application icon.
-
-### Changed
-
-- Clinical and session preset pill buttons grow to fit their full label (theme
-  ``max-width`` cap removed).
-- Step 1 and Step 2 scale name/value fields widen as needed to show the full text.
-
-### Fixed
-
-- Step 1 clinical preset buttons disappearing after adding a preset in settings
-  (horizontal scroll strip sizing).
-- Step 3 session settings: external vertical scrollbar column (same layout as Step 1;
-  no overlap with electrode canvases).
-- Dependency audit: pin ``uv>=0.11.15`` (GHSA-4gg8-gxpx-9rph).
-
-## [0.4.0] - 2026-06-01
-
-### Changed
-
-- Step 1 clinical preset buttons scroll horizontally when they do not fit on one row.
-
-### Fixed
-
-- Wizard window: title-bar maximize and resize on steps 1+ (step 0 stays compact).
-- Step 1 initial settings: vertical scrollbar in its own column; no overlap with electrode canvases.
-
-## [0.4.0b2] - 2026-05-21
-
-### Added
-
 - In-app **Update now** on the update-available dialog: downloads and runs the
   platform install scripts (``install.ps1`` on Windows, ``install.sh`` on macOS /
   Linux) for the selected GitHub release tag, then prompts you to restart the
@@ -90,6 +59,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   GitHub link) in a separate window.
 - ``dbs_annotator.utils.auto_update`` with optional ``dry_run=True`` (PowerShell
   ``-WhatIf`` / ``install.sh --dry-run``) for maintainers to preview an install.
+- Read the Docs: dark outer page background (matching the sidebar); browser tab
+  favicon uses the application icon.
 - Read the Docs screenshot pipeline: home screen (light and dark theme), clinical
   and session scales settings dialogs, and regenerated workflow captures at
   native resolution (HiDPI-aware screen grab, improved PNG settings).
@@ -103,6 +74,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Clinical and session preset pill buttons grow to fit their full label (theme
+  ``max-width`` cap removed).
+- Step 1 and Step 2 scale name/value fields widen as needed to show the full text.
 - **Help** dialog rewritten around the standard **Complete Workflow** programming
   pipeline, timestamped ``task-programming`` TSV output, and Word/PDF reports;
   notes that each stimulation configuration is saved and summarised in reports;
@@ -146,8 +120,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- Step 1 clinical preset buttons disappearing after adding a preset in settings
+  (horizontal scroll strip sizing).
+- Step 3 session settings: external vertical scrollbar column (same layout as Step 1;
+  no overlap with electrode canvases).
 - Dependency audit: pin ``idna>=3.15`` (GHSA-65pc-fj4g-8rjx); allow ``idna`` in
   ``exclude-newer-package`` so the fix is not blocked by the one-week cooldown.
+- Dependency audit: pin ``uv>=0.11.15`` (GHSA-4gg8-gxpx-9rph).
 - Update checker: HTTPS uses the ``certifi`` CA bundle (fixes failed or empty
   GitHub API responses in Briefcase MSI/ZIP on Windows); compares against
   ``APP_VERSION``; empty or invalid release data surfaces as errors instead of
@@ -171,6 +150,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Persist deactivated Step 3 session scales as ``NaN`` in the session TSV and omit them from Word and PDF reports. ([#94](https://github.com/Brain-Modulation-Lab/DBSAnnotator/pull/94))
 - Refreshed ``uv.lock`` with upgraded dependencies (including security-related updates for
   ``pip`` and ``gitpython``). ([#95](https://github.com/Brain-Modulation-Lab/DBSAnnotator/pull/95))
+
 ### Fixed
 
 - Fix `install.ps1` when run with `iex`: move install into a nested function so `$PSCmdlet` binds; document `iex` vs script parameters (`& ([scriptblock]::Create((iwr …).Content))` or local `install.ps1`). ([#77](https://github.com/Brain-Modulation-Lab/DBSAnnotator/pull/77))
@@ -184,6 +164,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Add a Windows PowerShell installer (``scripts/install.ps1``) and README one-liner to install the portable release ``.zip`` from GitHub when the MSI is unsigned. ([#70](https://github.com/Brain-Modulation-Lab/DBSAnnotator/pull/70))
 - Add ``scripts/install.sh`` (curl/wget) to install from GitHub Releases on Linux x86_64 and macOS (raw ``.tar.gz`` when present, else ``.deb`` / ``.dmg``), with README and installation docs. ([#71](https://github.com/Brain-Modulation-Lab/DBSAnnotator/pull/71))
+
 ## [0.4.0a1] - 2026-04-22
 
 ### Added

docs/_static/favicon-32.png

@@ -58,7 +58,8 @@
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
 html_css_files = ["custom.css"]
-# Browser tab icon (same asset as the packaged Qt / Briefcase application).
+# Browser tab icon — cream background for RTD only
+# (regenerate: scripts/generate_docs_favicon.py).
 html_favicon = "_static/favicon.ico"
 
 html_theme_options = {

docs/_static/favicon.ico

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""Generate Read the Docs favicons with a light cream background.
+
+The packaged desktop app keeps the default logo icon; RTD uses these files
+under ``docs/_static/`` only (see ``docs/conf.py`` ``html_favicon``).
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from PIL import Image
+
+ROOT = Path(__file__).resolve().parents[1]
+SOURCE = ROOT / "icons" / "logosimple" / "logosimple-256.png"
+OUT_DIR = ROOT / "docs" / "_static"
+# Warm off-white ("panna") — distinct from the app's dark-framed icon.
+BACKGROUND = "#FAF6F0"
+ICO_SIZES = (16, 32, 48)
+
+
+def _render(size: int) -> Image.Image:
+    logo = Image.open(SOURCE).convert("RGBA")
+    canvas = Image.new("RGBA", (size, size), BACKGROUND)
+    pad = max(2, size // 14)
+    inner = size - 2 * pad
+    logo.thumbnail((inner, inner), Image.Resampling.LANCZOS)
+    x = (size - logo.width) // 2
+    y = (size - logo.height) // 2
+    canvas.paste(logo, (x, y), logo)
+    return canvas.convert("RGB")
+
+
+def main() -> None:
+    if not SOURCE.is_file():
+        raise FileNotFoundError(f"Logo not found: {SOURCE}")
+
+    OUT_DIR.mkdir(parents=True, exist_ok=True)
+    icons = [_render(size) for size in ICO_SIZES]
+    icons[0].save(
+        OUT_DIR / "favicon.ico",
+        format="ICO",
+        sizes=[(size, size) for size in ICO_SIZES],
+        append_images=icons[1:],
+    )
+    _render(32).save(OUT_DIR / "favicon-32.png", format="PNG")
+    print(f"Wrote {OUT_DIR / 'favicon.ico'} and {OUT_DIR / 'favicon-32.png'}")
+
+
+if __name__ == "__main__":
+    main()