doc(opal): Tell new hunters to read a guide

vEnhance · Sep 13, 2024 · 308f316 · 308f316
1 parent 7d39230
commit 308f316
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 6 deletions.
diff --git a/opal/templates/opal/opalhunt_list.html b/opal/templates/opal/opalhunt_list.html
@@ -79,10 +79,14 @@ <h1>About</h1>
 </ul>
 <h2>So what is a puzzle hunt anyways?</h2>
 <p>
-  Read
-  <a href="https://blog.vero.site/post/puzzlehunts">Brian Chen's introduction</a>!
-  Evan also has some stuff written on
-  <a href="https://web.evanchen.cc/puzzlehunt.html">https://web.evanchen.cc/puzzlehunt.html</a>.
+  If you've never done a puzzle hunt before, you probably should at least skim
+  <a href="https://blog.vero.site/post/puzzlehunts">Brian Chen's introduction</a>
+  before you start
+  (so you know basic things like A=1, ..., Z=26, indexing into phrases,
+  alphabetical ordering, encodings, etc.).
+  You'll probably also want print out all the
+  <a href="https://web.evanchen.cc/upload/EvanPuzzleCodings.pdf">standard puzzle encodings</a>
+  so you can recognize them as they come up.
 </p>
 <p>
   In short, a puzzle gives you some data,

diff --git a/opal/templates/opal/opalpuzzle_list.html b/opal/templates/opal/opalpuzzle_list.html
@@ -6,8 +6,11 @@
 {% block layout-content %}
   <p>
     Good luck!
-    And read the <a href="{% url "opal-rules" %}">rules</a>
-    if you haven't already.
+    Read the <a href="{% url "opal-rules" %}">rules</a> if you haven't already.
+    And if you're new to puzzle hunts, you should probably skim
+    <a href="https://blog.vero.site/post/puzzlehunts">Brian Chen's intro guide</a>
+    and have a copy of some puzzle codes sheet on hand
+    (<a href="https://web.evanchen.cc/upload/EvanPuzzleCodings.pdf">here's mine</a>).
   </p>
   <p>
     Hint requests can be sent to Evan's usual email, if you're stuck on anything.