From 5232e760bec89265dd4dda6ad48893b71230187e Mon Sep 17 00:00:00 2001
From: Nathan Schneider <n@nathanschneider.info>
Date: Fri, 20 Mar 2026 15:12:19 -0600
Subject: [PATCH] Update help/about text

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 bicorder-app/src/components/HelpModal.svelte | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/bicorder-app/src/components/HelpModal.svelte b/bicorder-app/src/components/HelpModal.svelte
index 3887271..c992b68 100644
--- a/bicorder-app/src/components/HelpModal.svelte
+++ b/bicorder-app/src/components/HelpModal.svelte
@@ -24,15 +24,17 @@
 
       <div class="modal-body">
       <p>The Protocol Bicorder is a diagnostic tool for the study of protocols. It allows a human or machine user to evaluate protocol characteristics along a series of gradients between opposing terms.</p>
-      <p>The name is a tribute to the tricorder, a fictional device in the Star Trek universe that the characters can use to obtain all manner of empirical data about their surroundings.</p>
-      <p>To carry out the diagnostic, consider the protocol from the perspective of one gradient at a time. Determine where the protocol lies between two terms, with <code>1</code> closest to <code>term_left</code> and <code>9</code> closest to <code>term_right</code>.</p>
-      <p>A middle <code>value</code> like <code>5</code> means "a bit of both." Leaving the gradient <code>value</code> as <code>null</code> means "not applicable."</p>
+      <p>To carry out the diagnostic, consider the protocol from the perspective of one gradient at a time. Determine where the protocol lies between two terms, with <code>1</code> closest to the left-side term and closest to the term on the right. Press on the terms for brief definitions.</p>
+      <p>A middle value like <code>5</code> means that the protocol reflects both terms equally. If the gradients don't seem relevant to the protocol, don't give a score or press <code>N/A</code>.</p>
       <p>Use the <code>notes</code> field to add context or explanation.</p>
-      <p>Use the menu (☰) to toggle between focused/list modes and short/long forms. Short form includes only the most salient gradients.</p>
+      <p>Use the menu (☰) to toggle between focused/list modes and short/long forms. The default short form includes only the most salient gradients, but the long form may include important gradients for understanding the protocol at hand.</p>
+      <p>At the end, you'll have the option to <code>Upload</code> your readings to an open repository, <a href="https://git.medlab.host/ntnsndr/protocol-bicorder-data" target="_blank">located here</a>.
       <p>Happy protocol watching!</p>
 
       <hr class="divider" />
 
+      <p>The name is a tribute to the tricorder, a fictional device in the Star Trek universe that the characters can use to obtain all manner of empirical data about their surroundings.</p>
+
       <p class="credits">Initiated by <a href="https://nathanschneider.info" rel="nofollow">Nathan Schneider</a>; <a href="https://git.medlab.host/ntnsndr/protocol-bicorder/src/branch/main/bicorder-app" rel="nofollow">source code</a> licensed under the <a href="https://firstdonoharm.dev/" rel="nofollow">Hippocratic License</a> (do no harm!).</p>
       </div>
     </div>