Skip to content

Commit

Permalink
doc(opal): be less scary
Browse files Browse the repository at this point in the history
  • Loading branch information
vEnhance committed Dec 17, 2024
1 parent 8545e3a commit c6c890b
Showing 1 changed file with 11 additions and 14 deletions.
25 changes: 11 additions & 14 deletions opal/templates/opal/instructions_authors.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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>
Expand Down

0 comments on commit c6c890b

Please sign in to comment.