From 76d4e6e4c8f8da2c476c8c9acbe34c0881ae666c Mon Sep 17 00:00:00 2001
From: Xurkon <Kancerous@gmail.com>
Date: Fri, 12 Jun 2026 18:15:21 -0500
Subject: [PATCH] docs: move recommendations to minimap icon sliders

---
 CHANGELOG.md                                       |  2 +-
 .../Options/GeneralTab/QuestieOptionsGeneral.lua   |  9 ---------
 Modules/Options/IconsTab/QuestieOptionsIcons.lua   | 14 ++++++++++++--
 3 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5827038..0c1e7d7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -41,7 +41,7 @@
 
 ### Bug Fixes
 
-- **[Tooltip UI - Low/High-End Recommendations]** Added a short recommendation block in the Learner Tooltips settings so low-end users have a lighter starting point and high-end users can enable the full tooltip stack without guessing which toggles belong together.
+- **[Icons UI - Minimap Cutoff/Fade Suggestions]** Added short low-end and high-end recommendation text to the Minimap Icon Range Cutoff and Minimap Icon Fade Distance controls so the icon settings explain their intended starting points instead of leaving players to guess.
 - **[Map - Minimap Fade No Longer Hides Icons]** (#17) Distance-based minimap fading now clamps to the configured faded-icon opacity floor instead of reaching 0 alpha. The fade distance can visually de-emphasize distant icons, but only the range cutoff can remove them from the minimap.
 - **[Regression Tests - Learner Spawn And Tooltip Fallback]** Fixed the two previously failing specs: AscensionDB-owned NPC spawn overrides now keep their curated coordinates even in learner mode, preventing stale learner zones from leaking wrong-corner pins; and NPC quest-start tooltip fallback now calls `QuestieDB:GetQuest` correctly so objective summary text appears when no live objective tooltip is registered.
 - **[Performance - Minimap Filter And Learner Kill Hot Paths]** (#20) Reduced two likely stutter sources introduced after 1.6.2: minimap fade passes now cache expensive quest-filter visibility checks for already-visible icons instead of re-running them every 0.1s per icon, while still forcing a fresh check before hidden icons reappear; and the learner kill path no longer runs the spawn-evidence merge scan before the merger's three-evidence minimum can succeed.
diff --git a/Modules/Options/GeneralTab/QuestieOptionsGeneral.lua b/Modules/Options/GeneralTab/QuestieOptionsGeneral.lua
index f822884..4ca38f1 100644
--- a/Modules/Options/GeneralTab/QuestieOptionsGeneral.lua
+++ b/Modules/Options/GeneralTab/QuestieOptionsGeneral.lua
@@ -496,15 +496,6 @@ function QuestieOptions.tabs.general:Initialize()
                         order = 8.55,
                         name = function() return l10n('Learner Tooltips'); end,
                     },
-                    learnerTooltipRecommendation = {
-                        type = "description",
-                        order = 8.555,
-                        name = function()
-                            return l10n(
-                                "Low-end PC: keep the learner extras minimal. Start with learner tooltips on, but leave the secondary tooltip, data source line, auto-resize, and the extra learner detail lines off unless you need them.\nHigh-end PC: turn on learner tooltips, the secondary tooltip, data source, spawn line, confidence line, total spawns, and auto-resize."
-                            )
-                        end,
-                    },
                     learnerTooltips = {
                         type = "toggle",
                         order = 8.56,
diff --git a/Modules/Options/IconsTab/QuestieOptionsIcons.lua b/Modules/Options/IconsTab/QuestieOptionsIcons.lua
index b8fea91..d13a986 100644
--- a/Modules/Options/IconsTab/QuestieOptionsIcons.lua
+++ b/Modules/Options/IconsTab/QuestieOptionsIcons.lua
@@ -531,7 +531,12 @@ function QuestieOptions.tabs.icons:Initialize()
                         type = "range",
                         order = 4.35,
                         name = function() return l10n('Minimap Icon Range Cutoff'); end,
-                        desc = function() return l10n('How far away minimap icons can remain visible.\n(Default: %s)', optionsDefaults.profile.minimapIconRangeCutoff); end,
+                        desc = function()
+                            return l10n(
+                                "How far away minimap icons can remain visible.\nSuggested low-end PC range: 100-250.\nSuggested high-end PC range: 466-1000.\n(Default: %s)",
+                                optionsDefaults.profile.minimapIconRangeCutoff
+                            )
+                        end,
                         width = 3.1,
                         min = 25,
                         max = 1000,
@@ -546,7 +551,12 @@ function QuestieOptions.tabs.icons:Initialize()
                         type = "range",
                         order = 4.4,
                         name = function() return l10n('Minimap Icon Fade Distance'); end,
-                        desc = function() return l10n('How much objective icons should fade depending on distance.\n(Default: %s)', optionsDefaults.profile.fadeLevel); end,
+                        desc = function()
+                            return l10n(
+                                "How much objective icons should fade depending on distance.\nSuggested low-end PC range: 100-250.\nSuggested high-end PC range: match or exceed the cutoff if you want no distance fade.\n(Default: %s)",
+                                optionsDefaults.profile.fadeLevel
+                            )
+                        end,
                         width = 3.1,
                         min = 10,
                         max = 1000,