From 18bbcbf6603656687c4065c5ec2a31739b5c738e Mon Sep 17 00:00:00 2001
From: Rephl3x <zak.bearman@amslabs.net>
Date: Sat, 24 Jan 2026 19:09:05 +1300
Subject: [PATCH] Document fix buttons in how-it-works

---
 frontend/app/how-it-works/page.tsx | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/frontend/app/how-it-works/page.tsx b/frontend/app/how-it-works/page.tsx
index f80bbc7..f25cbfc 100644
--- a/frontend/app/how-it-works/page.tsx
+++ b/frontend/app/how-it-works/page.tsx
@@ -76,12 +76,38 @@ export default function HowItWorksPage() {
       </section>
 
       <section className="how-callout">
-        <h2>Why Magent sometimes says “waiting”</h2>
+        <h2>Why Magent sometimes says "waiting"</h2>
         <p>
           If the search helper cannot find a match yet, Magent will say there is nothing to grab.
           That does not mean it is broken. It usually means the release is not available yet.
         </p>
       </section>
+
+      <section className="how-flow">
+        <h2>Fix buttons and what they do</h2>
+        <ul className="how-steps">
+          <li>
+            <strong>Search for releases</strong> checks the torrent sources (via Prowlarr) and shows
+            you a list you can choose from.
+          </li>
+          <li>
+            <strong>Download selected release</strong> sends the pick to Sonarr/Radarr so it can
+            download and import it correctly.
+          </li>
+          <li>
+            <strong>Search and auto-download</strong> asks Sonarr/Radarr to find the best match and
+            grab it automatically.
+          </li>
+          <li>
+            <strong>Resume download</strong> tells qBittorrent to continue a paused download when it
+            is already there.
+          </li>
+          <li>
+            <strong>Add to library queue</strong> re-adds the request into Sonarr/Radarr when it is
+            missing there.
+          </li>
+        </ul>
+      </section>
     </main>
   )
 }