Merge pull request #111 from xexyl/register

Update pw-change.html, register.html, submit.html

next/pw-change.html

@@ -448,25 +448,27 @@ given. Click “Login”.</p>
 you will be required to change your password. Assuming everything is fine, that
 would look something like:</p>
 <p><img src="../png/submit.first-login.png"
- alt="submit server password change required"
+ alt="submit server initial login requires your password to be changed"
  width=710 height=808></p>
 <p>As you can see, on your first login you <strong>MUST</strong> change your password. If you do
 not do this within 72 hours <strong>YOUR ACCOUNT WILL BE CLOSED</strong> and you’ll have to
-register again!</p>
-<p>Put in your login (UUID username), your old (initial) password and a new password.</p>
-<p>Click “Change Password”.</p>
-<p><strong>NOTE</strong>: If enter an improper new password, you will see an error message
-that looks similar to this:</p>
-<p><img src="../png/submit.invalid-passwd.png"
- alt="submit server password change error"
- width=710 height=808></p>
-<p>If that happens, choose a proper new password and try again.</p>
-<p>Once you’ve changed your password you will be able to log in again with your UUID
-username and new password. This is what it will look like when you change your
-password:</p>
-<p><img src="../png/submit.passwd-changed.png"
- alt="submit server password changed"
- width=710 height=344></p>
+register again! In that case, it will say something like this:</p>
+<blockquote>
+<p>ERROR: Sorry (tm Canada 🇨) you cannot login at this time.</p>
+</blockquote>
+<p>Assuming you did login in time, you should put in your login (UUID username),
+your old (initial) password and a new password and then click “Change Password”.</p>
+<p><strong>NOTE</strong>: if you have put in your old password, you’ll get the following error:</p>
+<blockquote>
+<p>ERROR: Password not changed<br>
+ERROR: invalid old password</p>
+</blockquote>
+<p>Once you’ve changed your password successfully you will be able to log in again
+with your UUID username and new password. When you have done this it will
+report:</p>
+<blockquote>
+<p>• Password successfully changed.</p>
+</blockquote>
 <p>When the contest is <a href="../faq.html#open">open</a>, proceed with
 <a href="../quick-start.html#step_5">Step 5: Obtain and compile the latest mkiocccentry toolkit</a>.</p>
 <!--

next/pw-change.md

@@ -31,33 +31,28 @@ you will be required to change your password. Assuming everything is fine, that
 would look something like:
 
 <img src="../png/submit.first-login.png"
- alt="submit server password change required"
+ alt="submit server initial login requires your password to be changed"
  width=710 height=808>
 
 As you can see, on your first login you **MUST** change your password. If you do
 not do this within 72 hours **YOUR ACCOUNT WILL BE CLOSED** and you'll have to
-register again!
+register again! In that case, it will say something like this:
 
-Put in your login (UUID username), your old (initial) password and a new password.
+> ERROR: Sorry (tm Canada 🇨) you cannot login at this time.
 
-Click "Change Password".
+Assuming you did login in time, you should put in your login (UUID username),
+your old (initial) password and a new password and then click "Change Password".
 
-**NOTE**: If enter an improper new password, you will see an error message
-that looks similar to this:
+**NOTE**: if you have put in your old password, you'll get the following error:
 
-<img src="../png/submit.invalid-passwd.png"
- alt="submit server password change error"
- width=710 height=808>
+> ERROR: Password not changed<br>
+> ERROR: invalid old password
 
-If that happens, choose a proper new password and try again.
+Once you've changed your password successfully you will be able to log in again
+with your UUID username and new password. When you have done this it will
+report:
 
-Once you've changed your password you will be able to log in again with your UUID
-username and new password. This is what it will look like when you change your
-password:
-
-<img src="../png/submit.passwd-changed.png"
- alt="submit server password changed"
- width=710 height=344>
+> • Password successfully changed.
 
 When the contest is [open](../faq.html#open), proceed with
 [Step 5: Obtain and compile the latest mkiocccentry toolkit](../quick-start.html#step_5).

next/register.html

@@ -442,11 +442,11 @@ in order to register for the IOCCC.</p>
 </ul>
 <p><strong>NOTE</strong>: For submissions with multiple authors, only one author needs to subscribe.</p>
 <p><img src="../png/register.0_531x445-signup.png"
- alt="signup for a mailing list"
+ alt="signup for a mailing list screenshot"
  width=531 height=445></p>
 <p>After clicking <strong>((Next &gt;&gt;))</strong>, you will be notified that you will receive an email:</p>
 <p><img src="../png/register.1_633x163-verify.png"
- alt="verify your email notification"
+ alt="verify your email notification screenshot"
  width=633 height=163></p>
 <div id="step_c">
 <h2 id="step-c-open-the-subscription-consent-email-message">Step C: Open the Subscription consent email message</h2>
@@ -470,7 +470,7 @@ you have tried a few times, <a href="../contact.html">Contact the IOCCC</a> to a
 <code>https://www.freelists.org/v/ioccc28-reg/SOME-RANDOM-STUFF</code>.</p>
 <p>Click on that link. The email might look the below:</p>
 <p><img src="../png/register.2_590x253-verify-email.png"
- alt="Subscription consent email"
+ alt="Subscription consent email screenshot"
  width=590 height=253></p>
 <p><strong>NOTE</strong>: If you prefer to <strong>NOT</strong> click links in email, simply copy that
 URL from your “Subscription consent email” and paste it into your browser.</p>
@@ -479,7 +479,7 @@ URL from your “Subscription consent email” and paste it into your browser.</
 </div>
 <p>In your browser, for the link referenced in <a href="#step_c">Step C</a>, click the <strong>((Next &gt;&gt;))</strong> button.</p>
 <p><img src="../png/register.3_428x205-confirm.png"
- alt="confirm your email"
+ alt="confirm your email screenshot"
  width=428 height=205></p>
 <div id="step_e">
 <h2 id="step-e-verify-you-have-read-the-mailing-list-polices-and-that-you-consent-to-receiving-emails">Step E: Verify you have read the mailing list polices and that you consent to receiving emails</h2>
@@ -493,11 +493,11 @@ URL from your “Subscription consent email” and paste it into your browser.</
 <p>Once you have done this by clicking the 3 checkboxes, click the <strong>((Next &gt;&gt;))</strong>
 button:</p>
 <p><img src="../png/register.4_657x446-subscribe.png"
- alt="complete subscription"
+ alt="complete subscription screenshot"
  width=657 height=446></p>
 <p>After clicking <strong>((Next &gt;&gt;))</strong>, you will be notified that you will receive an email:</p>
 <p><img src="../png/register.5_487x154-done.png"
- alt="registration is complete"
+ alt="registration is complete screenshot"
  width=487 height=154></p>
 <div id="step_f">
 <h2 id="step-f-read-the-welcome-email">Step F: Read the Welcome email</h2>
@@ -507,7 +507,7 @@ button:</p>
 <pre><code>    Welcome to &#39;ioccc28-reg&#39;</code></pre>
 <p>Read the “Welcome” email.</p>
 <p><img src="../png/register.6_413x657-welcome.png"
- alt="Welcome email"
+ alt="Welcome email screenshot"
  width=414 height=657></p>
 <p><strong>NOTE</strong>: The “Welcome” email is usually sent by the FreeLists
 List Manager within a minute after clicking the <strong>((Next &gt;&gt;))</strong> button.

next/register.md

@@ -23,13 +23,13 @@ For details see the "[how the contest status impacts registration](#status_impac
 **NOTE**: For submissions with multiple authors, only one author needs to subscribe.
 
 <img src="../png/register.0_531x445-signup.png"
- alt="signup for a mailing list"
+ alt="signup for a mailing list screenshot"
  width=531 height=445>
 
 After clicking **((Next >>))**, you will be notified that you will receive an email:
 
 <img src="../png/register.1_633x163-verify.png"
- alt="verify your email notification"
+ alt="verify your email notification screenshot"
  width=633 height=163>
 
 
@@ -63,7 +63,7 @@ Click on that link. The email might look the below:
 
 
 <img src="../png/register.2_590x253-verify-email.png"
- alt="Subscription consent email"
+ alt="Subscription consent email screenshot"
  width=590 height=253>
 
 **NOTE**: If you prefer to **NOT** click links in email, simply copy that
@@ -77,7 +77,7 @@ URL from your "Subscription consent email" and paste it into your browser.
 In your browser, for the link referenced in [Step C](#step_c), click the **((Next >>))** button.
 
 <img src="../png/register.3_428x205-confirm.png"
- alt="confirm your email"
+ alt="confirm your email screenshot"
  width=428 height=205>
 
 
@@ -95,13 +95,13 @@ Once you have done this by clicking the 3 checkboxes, click the **((Next >>))**
 button:
 
 <img src="../png/register.4_657x446-subscribe.png"
- alt="complete subscription"
+ alt="complete subscription screenshot"
  width=657 height=446>
 
 After clicking **((Next >>))**, you will be notified that you will receive an email:
 
 <img src="../png/register.5_487x154-done.png"
- alt="registration is complete"
+ alt="registration is complete screenshot"
  width=487 height=154>
 
 
@@ -119,7 +119,7 @@ You should receive an automated Welcome message from the FreeLists List Manager
 Read the "Welcome" email.
 
 <img src="../png/register.6_413x657-welcome.png"
- alt="Welcome email"
+ alt="Welcome email screenshot"
  width=414 height=657>
 
 **NOTE**: The "Welcome" email is usually sent by the FreeLists

next/submit.html

@@ -436,12 +436,16 @@ might be offline and unreachable as a website.</p>
 in your browser. Fill in your login credentials and click “Login”.
 It might look something like:</p>
 <p><img src="../png/submit.login.png"
- alt="submit server login page"
+ alt="submit server login page screenshot"
  width=710 height=344></p>
-<p><strong>NOTE</strong>: if the contest is NOT open you will see something like this instead:
-<img src="../png/submit.contest-closed.png"
- alt="submit server contest closed"
- width=710 height=806></p>
+<p><strong>NOTE</strong>: if the contest is NOT open you will see something like this instead:</p>
+<blockquote>
+<p>The contest is NOT yet open for submissions.<br>
+Sorry (tm Canada 🇨), the IOCCC is not yet open.<br>
+The IOCCC is scheduled to open at 2025-03-05 23:19:17.131107 UTC.<br></p>
+<p>Message(s):<br>
+The IOCCC is not yet open for submissions.</p>
+</blockquote>
 <p>Assuming it is open, and if you’ve not logged in before, you’ll have to change
 your password first. See the file <a href="pw-change.html">pw-change.html</a> for more
 details. After that you will have to log back in.</p>
@@ -450,44 +454,75 @@ submission so if you update a submission, make sure you choose the right one so
 you do not replace the wrong one!</p>
 <p>Here is what it looks like without any uploads and no slot selected:</p>
 <p><img src="../png/submit.slots.png"
- alt="submit server slots"
- width=710 height=806></p>
+ alt="submit server submission slots list to select from with no slot selected
+ screenshot" width=710 height=806></p>
 <p>Select a slot and then select a file by clicking the button “Choose File”. After
 doing this, it should look something like:</p>
 <p><img src="../png/submit.slot-file.png"
- alt="submit server slot and file selected"
+ alt="submit server submission slot selected with a file chosen to be uploaded screenshot"
  width=717 height=865></p>
 <p>If you need to change the file to upload, you can mouseover the file and click
-it. If you wait a moment it’ll show the current filename. It will look something
-like this:</p>
-<p><img src="../png/submit.change-file.png"
- alt="submit server change file"
- width=717 height=865></p>
+it. If you wait a moment it’ll show the current filename.</p>
 <p>Once you’re certain you have selected the correct file, click “Submit”, below
 the file selection step.</p>
-<p>When it’s uploaded it should look something like this:</p>
-<p><img src="../png/submit.submission-uploaded.png"
- alt="submit server submission uploaded"
- width=717 height=525></p>
-<p>Here you see the details, in particular:</p>
+<p>When it’s uploaded it should say something like:</p>
+<blockquote>
+<p>• Uploaded file: submit.9971ada4-b6ae-427d-a7ec-e67a30362cdb-0.1740838915.txz</p>
+</blockquote>
+<p>And in the slot it will give you important details like:</p>
 <ul>
-<li>the status of the submission</li>
+<li>the status of the submission (on upload it will say: <code>"uploaded file into slot"</code>).</li>
 <li>the filename, which will be in the correct format, assuming you used
 <code>mkiocccentry(1)</code> which is <strong>HIGHLY</strong> recommended so that you do not break <a href="rules.html#rule17">Rule
 17</a>!</li>
 <li>the file length, which <code>txzchk(1)</code> will also verify (the file itself and the
-tarball listing)</li>
-<li>the upload date</li>
-<li>the SHA256 hash of the file</li>
+tarball listing).</li>
+<li>the upload date.</li>
+<li>the SHA256 hash of the file.</li>
 </ul>
 <p>Now if you’re done, log out.</p>
+<p>If, on the other hand,, you upload a file that is too big you will see something
+like:</p>
+<blockquote>
+<p>The file size of N exceeds the maximum size of 3999971.</p>
+</blockquote>
+<p>And if you try uploading an empty file you’ll instead see:</p>
+<blockquote>
+<p>The must not be empty.</p>
+</blockquote>
+<p>And if you see something like:</p>
+<blockquote>
+<p>Filename for slot: 0 must match this regular expression: <code>^submit.dd3d30c2-d8d0-4506-adcd-d4e029147f39-0\.[1-9][0-9] {9,}\.txz$</code></p>
+</blockquote>
+<p>where <code>0</code> is the slot and <code>dd3d30c2-d8d0-4506-adcd-d4e029147f39-01</code> is the UUID
+then you <strong>MUST</strong> upload a properly named XZ compressed tarball, <strong>MAKING SURE</strong> you
+package it with <code>mkiocccentry</code>!</p>
+<p>If later on you log in and see something like:</p>
+<blockquote>
+<p>Status: server slot error code: 1! Use mkiocccentry to rebuild and resubmit to
+this slot.</p>
+</blockquote>
+<p>or:</p>
+<blockquote>
+<p>Status: submit file failed the txzchk test! Use mkiocccentry to rebuild and resubmit to this slot.</p>
+</blockquote>
+<p>… or <strong>ANY</strong> other error then you <strong>MUST FIX</strong> your submission, repackage your
+tarball with <code>mkiocccentry</code> and upload to the same slot again! If you do not fix
+this your submission <strong>WILL</strong> be rejected for violating <a href="rules.html#rule17">Rule
+17</a>!</p>
 <p>After the submission deadline is reached, you can log in to check the status of
-your submissions. Here is what it will look like when the judges have verified
+your submissions. This is what it will say when the judges have verified
 that your tarball / submission has been validated (NOT judged), by <code>txzchk(1)</code>
 and <code>chkentry(1)</code>:</p>
-<p><img src="../png/submit.status-updated.png"
- alt="submit server status updated"
- width=717 height=217></p>
+<blockquote>
+<p>Status: the format of this submission has been validated.</p>
+</blockquote>
+<p><strong>IMPORTANT</strong>: this does <strong>NOT</strong> mean that your submission does not violate the
+rules or that everything is OK once the tarball is extracted; it simply means
+the tests performed by the tools passed. If you find a flaw in the tool and
+abuse it and the tests pass then you stand a significant chance of having your
+submission rejected for violating <a href="rules.html#rule17">Rule 17</a>, even if the
+tests passed.</p>
 <p>For details on <code>txzchk</code>, see the
 FAQ on “<a href="../faq.html#txzchk">txzchk</a>”.</p>
 <p>For details on <code>chkentry</code>, see the

next/submit.md

@@ -14,13 +14,17 @@ in your browser. Fill in your login credentials and click "Login".
 It might look something like:
 
 <img src="../png/submit.login.png"
- alt="submit server login page"
+ alt="submit server login page screenshot"
  width=710 height=344>
 
 **NOTE**: if the contest is NOT open you will see something like this instead:
-<img src="../png/submit.contest-closed.png"
- alt="submit server contest closed"
- width=710 height=806>
+
+> The contest is NOT yet open for submissions.<br>
+> Sorry (tm Canada 🇨), the IOCCC is not yet open.<br>
+> The IOCCC is scheduled to open at 2025-03-05 23:19:17.131107 UTC.<br>
+>
+> Message(s):<br>
+> The IOCCC is not yet open for submissions.
 
 Assuming it is open, and if you've not logged in before, you'll have to change
 your password first. See the file [pw-change.html](pw-change.html) for more
@@ -33,54 +37,85 @@ you do not replace the wrong one!
 Here is what it looks like without any uploads and no slot selected:
 
 <img src="../png/submit.slots.png"
- alt="submit server slots"
- width=710 height=806>
+ alt="submit server submission slots list to select from with no slot selected
+ screenshot" width=710 height=806>
 
 Select a slot and then select a file by clicking the button "Choose File". After
 doing this, it should look something like:
 
 <img src="../png/submit.slot-file.png"
- alt="submit server slot and file selected"
+ alt="submit server submission slot selected with a file chosen to be uploaded screenshot"
  width=717 height=865>
 
 If you need to change the file to upload, you can mouseover the file and click
-it. If you wait a moment it'll show the current filename. It will look something
-like this:
-
-<img src="../png/submit.change-file.png"
- alt="submit server change file"
- width=717 height=865>
+it. If you wait a moment it'll show the current filename.
 
 Once you're certain you have selected the correct file, click "Submit", below
 the file selection step.
 
-When it's uploaded it should look something like this:
+When it's uploaded it should say something like:
 
-<img src="../png/submit.submission-uploaded.png"
- alt="submit server submission uploaded"
- width=717 height=525>
+> • Uploaded file: submit.9971ada4-b6ae-427d-a7ec-e67a30362cdb-0.1740838915.txz
 
-Here you see the details, in particular:
+And in the slot it will give you important details like:
 
-- the status of the submission
+- the status of the submission (on upload it will say: `"uploaded file into
+slot"`).
 - the filename, which will be in the correct format, assuming you used
 `mkiocccentry(1)` which is **HIGHLY** recommended so that you do not break [Rule
 17](rules.html#rule17)!
 - the file length, which `txzchk(1)` will also verify (the file itself and the
-tarball listing)
-- the upload date
-- the SHA256 hash of the file
+tarball listing).
+- the upload date.
+- the SHA256 hash of the file.
 
 Now if you're done, log out.
 
+If, on the other hand,, you upload a file that is too big you will see something
+like:
+
+> The file size of N exceeds the maximum size of 3999971.
+
+And if you try uploading an empty file you'll instead see:
+
+> The must not be empty.
+
+And if you see something like:
+
+> Filename for slot: 0 must match this regular expression: `^submit.dd3d30c2-d8d0-4506-adcd-d4e029147f39-0\.[1-9][0-9]
+{9,}\.txz$`
+
+where `0` is the slot and `dd3d30c2-d8d0-4506-adcd-d4e029147f39-01` is the UUID
+then you **MUST** upload a properly named XZ compressed tarball, **MAKING SURE** you
+package it with `mkiocccentry`!
+
+If later on you log in and see something like:
+
+> Status: server slot error code: 1! Use mkiocccentry to rebuild and resubmit to
+this slot.
+
+or:
+
+> Status: submit file failed the txzchk test! Use mkiocccentry to rebuild and resubmit to this slot.
+
+... or **ANY** other error then you **MUST FIX** your submission, repackage your
+tarball with `mkiocccentry` and upload to the same slot again! If you do not fix
+this your submission **WILL** be rejected for violating [Rule
+17](rules.html#rule17)!
+
 After the submission deadline is reached, you can log in to check the status of
-your submissions. Here is what it will look like when the judges have verified
+your submissions. This is what it will say when the judges have verified
 that your tarball / submission has been validated (NOT judged), by `txzchk(1)`
 and `chkentry(1)`:
 
-<img src="../png/submit.status-updated.png"
- alt="submit server status updated"
- width=717 height=217>
+> Status: the format of this submission has been validated.
+
+**IMPORTANT**: this does **NOT** mean that your submission does not violate the
+rules or that everything is OK once the tarball is extracted; it simply means
+the tests performed by the tools passed. If you find a flaw in the tool and
+abuse it and the tests pass then you stand a significant chance of having your
+submission rejected for violating [Rule 17](rules.html#rule17), even if the
+tests passed.
 
 For details on `txzchk`, see the
 FAQ on "[txzchk](../faq.html#txzchk)".