From 463ce1e23c13504aff0b098bcab03ddc2ffdc55a Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Mon, 6 Apr 2026 02:51:30 +0000
Subject: [PATCH 1/2] feat(ui): add explanatory tooltip to transaction cost
 input

Adds a helpful tooltip to the "Transaction Cost (bps)" number input in the dashboard sidebar to provide a concrete mathematical example of basis points (10 bps = 0.10%), improving accessibility for users unfamiliar with financial terminology. Also includes a journal entry recording this UX learning.

Co-authored-by: aarjava <218419324+aarjava@users.noreply.github.com>
---
 .Jules/palette.md |  3 +++
 src/dashboard.py  | 10 +++++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)
 create mode 100644 .Jules/palette.md

diff --git a/.Jules/palette.md b/.Jules/palette.md
new file mode 100644
index 0000000..6911a4e
--- /dev/null
+++ b/.Jules/palette.md
@@ -0,0 +1,3 @@
+## 2024-04-06 - Concrete Examples for Financial Parameters
+**Learning:** Users can find financial jargon like "basis points" confusing, even in specialized dashboards. Providing concrete examples directly in the tooltip significantly improves clarity.
+**Action:** Always include a concrete mathematical example (e.g., "10 bps = 0.10%") in the `help` tooltip for inputs involving statistical or financial parameters like quantiles or basis points.
diff --git a/src/dashboard.py b/src/dashboard.py
index 4156c1d..5607720 100644
--- a/src/dashboard.py
+++ b/src/dashboard.py
@@ -190,7 +190,15 @@ def get_cache_key(*args) -> str:
 
     if mode == "Single-Asset":
         st.subheader("5. Backtest Settings")
-        bt_cost = st.number_input("Transaction Cost (bps)", value=DEFAULT_COST_BPS, step=1) / 10000
+        bt_cost = (
+            st.number_input(
+                "Transaction Cost (bps)",
+                value=DEFAULT_COST_BPS,
+                step=1,
+                help="Cost per trade in basis points (e.g., 10 bps = 0.10%).",
+            )
+            / 10000
+        )
         allow_short = st.checkbox("Allow Short Selling?", value=False)
     else:
         st.subheader("5. Alert Thresholds")

From 639762db257c48eec1721f9b8297ee0691ae95ff Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Mon, 6 Apr 2026 02:54:42 +0000
Subject: [PATCH 2/2] feat(ui): add explanatory tooltip to transaction cost
 input

Adds a helpful tooltip to the "Transaction Cost (bps)" number input in the dashboard sidebar to provide a concrete mathematical example of basis points (10 bps = 0.10%), improving accessibility for users unfamiliar with financial terminology. Also includes a journal entry recording this UX learning.

Co-authored-by: aarjava <218419324+aarjava@users.noreply.github.com>