From 5ba380d59052de01ffd96e25663134944c503afc Mon Sep 17 00:00:00 2001
From: Edward Betts <edward@4angle.com>
Date: Mon, 11 May 2026 15:22:01 +0100
Subject: [PATCH] Add how-it-works steps to home page and fix post-OAuth
 redirect

- Add three-step explanation (Search, Review, Save or skip) below the
  search form on the index page
- After a LoginNeeded during save, redirect to OAuth with next= pointing
  back to the article page showing the same candidate

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 templates/index.html | 33 +++++++++++++++++++++++++++++++--
 web_view.py          |  3 ++-
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/templates/index.html b/templates/index.html
index 11c14ec..46405a6 100644
--- a/templates/index.html
+++ b/templates/index.html
@@ -7,11 +7,40 @@
   <div class="row justify-content-center mt-5">
     <div class="col-md-6 text-center">
       <h1 class="mb-2">Missing Link</h1>
-      <p class="text-muted mb-4">Find unlinked mentions of a Wikipedia article and add the links.</p>
-      <form class="d-flex gap-2 justify-content-center" action="{{ url_for('index') }}">
+      <p class="text-muted mb-4">Find Wikipedia articles that mention a topic but don't link to it — then add the link.</p>
+      <form class="d-flex gap-2 justify-content-center mb-5" action="{{ url_for('index') }}">
         <input class="form-control" name="q" placeholder="Article title…" style="max-width:360px" autofocus>
         <button class="btn btn-primary" type="submit">Search</button>
       </form>
+      <div class="row g-4 text-start mt-1">
+        <div class="col-md-4">
+          <div class="d-flex gap-3">
+            <span class="fs-4">🔍</span>
+            <div>
+              <h6 class="mb-1">Search</h6>
+              <p class="text-muted small mb-0">Enter a Wikipedia article title. Missing Link searches for other articles that mention it by name but don't have a wikilink.</p>
+            </div>
+          </div>
+        </div>
+        <div class="col-md-4">
+          <div class="d-flex gap-3">
+            <span class="fs-4">👀</span>
+            <div>
+              <h6 class="mb-1">Review</h6>
+              <p class="text-muted small mb-0">For each candidate article, a diff shows exactly what would change. You can see the proposed link in context before doing anything.</p>
+            </div>
+          </div>
+        </div>
+        <div class="col-md-4">
+          <div class="d-flex gap-3">
+            <span class="fs-4">✅</span>
+            <div>
+              <h6 class="mb-1">Save or skip</h6>
+              <p class="text-muted small mb-0">Save the edit directly to Wikipedia with one click, or skip to the next candidate. Log in with your Wikipedia account to save edits.</p>
+            </div>
+          </div>
+        </div>
+      </div>
     </div>
   </div>
 
diff --git a/web_view.py b/web_view.py
index 6cc669c..ae2564d 100755
--- a/web_view.py
+++ b/web_view.py
@@ -318,7 +318,8 @@ def handle_post(url_title: str) -> Response:
     try:
         do_save(from_title, hit_title)
     except mediawiki_oauth.LoginNeeded:
-        return flask.redirect(flask.url_for("start_oauth"))
+        next_url = flask.url_for("article_page", url_title=url_title, title=hit_title)
+        return flask.redirect(flask.url_for("start_oauth", next=next_url))
     except (mediawiki_api.APIError, api.MediawikiError) as e:
         return flask.make_response(
             flask.render_template("error.html", message=f"Save failed: {e}"), 502