Merge pull request #111 from xexyl/register

Update pw-change.html, register.html, submit.html
2025-03-02 13:34:15 -08:00
commit 7ecc61594a
@@ -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>
+register again! In that case, it will say something like this:</p>
-<p>Put in your login (UUID username), your old (initial) password and a new password.</p>
+<blockquote>
-<p>Click “Change Password”.</p>
+<p>ERROR: Sorry (tm Canada 🇨) you cannot login at this time.</p>
-<p><strong>NOTE</strong>: If enter an improper new password, you will see an error message
+</blockquote>
-that looks similar to this:</p>
+<p>Assuming you did login in time, you should put in your login (UUID username),
-<p><img src="../png/submit.invalid-passwd.png"
+your old (initial) password and a new password and then click “Change Password”.</p>
- alt="submit server password change error"
+<p><strong>NOTE</strong>: if you have put in your old password, you’ll get the following error:</p>
- width=710 height=808></p>
+<blockquote>
-<p>If that happens, choose a proper new password and try again.</p>
+<p>ERROR: Password not changed<br>
-<p>Once you’ve changed your password you will be able to log in again with your UUID
+ERROR: invalid old password</p>
-username and new password. This is what it will look like when you change your
+</blockquote>
-password:</p>
+<p>Once you’ve changed your password successfully you will be able to log in again
-<p><img src="../png/submit.passwd-changed.png"
+with your UUID username and new password. When you have done this it will
- alt="submit server password changed"
+report:</p>
- width=710 height=344></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>
 <!--
@@ -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
+**NOTE**: if you have put in your old password, you'll get the following error:
 that looks similar to this:
-<img src="../png/submit.invalid-passwd.png"
+> ERROR: Password not changed<br>
- alt="submit server password change error"
+> ERROR: invalid old password
 width=710 height=808>
-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
+> • Password successfully changed.
 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>
 When the contest is [open](../faq.html#open), proceed with
 [Step 5: Obtain and compile the latest mkiocccentry toolkit](../quick-start.html#step_5).
@@ -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.
@@ -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
@@ -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:
+<p><strong>NOTE</strong>: if the contest is NOT open you will see something like this instead:</p>
-<img src="../png/submit.contest-closed.png"
+<blockquote>
- alt="submit server contest closed"
+<p>The contest is NOT yet open for submissions.<br>
- width=710 height=806></p>
+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"
+ alt="submit server submission slots list to select from with no slot selected
- width=710 height=806></p>
+ 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
+it. If you wait a moment it’ll show the current filename.</p>
 like this:</p>
 <p><img src="../png/submit.change-file.png"
 alt="submit server change file"
 width=717 height=865></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>When it’s uploaded it should say something like:</p>
-<p><img src="../png/submit.submission-uploaded.png"
+<blockquote>
- alt="submit server submission uploaded"
+<p>• Uploaded file: submit.9971ada4-b6ae-427d-a7ec-e67a30362cdb-0.1740838915.txz</p>
- width=717 height=525></p>
+</blockquote>
-<p>Here you see the details, in particular:</p>
+<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>
+tarball listing).</li>
-<li>the upload date</li>
+<li>the upload date.</li>
-<li>the SHA256 hash of the file</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"
+<blockquote>
- alt="submit server status updated"
+<p>Status: the format of this submission has been validated.</p>
- width=717 height=217></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
@@ -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"
+> The contest is NOT yet open for submissions.<br>
- width=710 height=806>
+> 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"
+ alt="submit server submission slots list to select from with no slot selected
- width=710 height=806>
+ 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
+it. If you wait a moment it'll show the current filename.
 like this:
 <img src="../png/submit.change-file.png"
 alt="submit server change file"
 width=717 height=865>
 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"
+> • Uploaded file: submit.9971ada4-b6ae-427d-a7ec-e67a30362cdb-0.1740838915.txz
 alt="submit server submission uploaded"
 width=717 height=525>
-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)
+tarball listing).
- the upload date
+- the upload date.
- the SHA256 hash of the file
+- 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"
+> Status: the format of this submission has been validated.
- alt="submit server status updated"
+
- width=717 height=217>
+**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)".