From c6c890bd39a65b4c250ebe807c6faa5b86c5d560 Mon Sep 17 00:00:00 2001
From: Evan Chen <evan@evanchen.cc>
Date: Tue, 17 Dec 2024 10:24:14 -0500
Subject: [PATCH] doc(opal): be less scary

---
 opal/templates/opal/instructions_authors.html | 25 ++++++++-----------
 1 file changed, 11 insertions(+), 14 deletions(-)

diff --git a/opal/templates/opal/instructions_authors.html b/opal/templates/opal/instructions_authors.html
index 911d17c6..656b2690 100644
--- a/opal/templates/opal/instructions_authors.html
+++ b/opal/templates/opal/instructions_authors.html
@@ -24,23 +24,24 @@ <h2>Required reading</h2>
   </ul>
   <h2>Warning</h2>
   <p>
-    If it's your first time writing,
+    If you've never done OPAL before, you should solve some past OPAL hunts
+    to understand what you're signing up for.
+  </p>
+  <p>
+    Besides that, if it's your first time writing,
     <strong>this is going to be a lot of work</strong>.
+    But hopefully it will be a lot of fun too!
     (For context,
     <a href="https://blog.evanchen.cc/2021/02/21/unnecessarily-detailed-stories-of-my-mystery-hunt-puzzles/">the first time I tried puzzle-writing</a>,
     each puzzle could take 24-60 hours to write, depending on the complexity.
-    Admittedly, these are Mystery Hunt puzzles, which are on a totally different scale.)
+    Admittedly, these are Mystery Hunt puzzles, which are on a totally different scale,
+    so it might be more like 10-20 hours for this.)
   </p>
   <p>
     Your first draft will, more likely than not,
     be completely gutted and go through lots of revisions.
     Expect to have a lot of back-and-forth discussion with your editor (me).
   </p>
-  <p>
-    Also, if you've never done OPAL before, you should solve some past OPAL hunts
-    to understand what you're signing up for.
-    It's a bad idea to sign up for writing OPAL without having ever tried a past hunt.
-  </p>
   <h2>Instructions</h2>
   <ol>
     <li>
@@ -52,20 +53,16 @@ <h2>Instructions</h2>
     <li>
       Within a few days of the deadline (hopefully),
       Evan will assign you an answer.
-      You (and co-authors) need to write a puzzle
-      that gives that specific answer.
+      You (and co-authors) need to write a puzzle that gives that specific answer.
       A deadline for a "first draft" of the puzzle is given.
-      <strong>I will enforce this deadline</strong>:
-      if you don't get me a draft by this deadline,
-      and you don't have a reasonable ETA, I will drop your puzzle.
+      I will enforce this deadline and drop puzzles that don't meet it.
     </li>
     <li>
       After that, I'll write back with edits and so on,
       together with deadlines (usually 2-6 weeks, depending on the depth of the revisions needed)
       on how long you have to get a revised draft to me.
       Again, deadlines will be enforced:
-      if you don't send revisions to me by the date I ask
-      and you don't have an ETA,
+      if you don't send revisions to me and you don't have an ETA,
       I will either finish the puzzle myself or scrap it altogether.
     </li>
     <li>