Improve upload submission FAQ

New screenshots have been added with new explanations. A couple files
were either deleted or renamed.

There were some fixes as well.

I have looked at the result on the web server and it appears to look and
read well and hopefully this will suffice for this part of the how to
submit FAQ.

faq.html

@@ -651,48 +651,85 @@ your entry and then re-run the <code>mkiocccentry</code> tool.</p>
 for doing so in your <code>remarks.md</code> file.</p>
 <p>See also <a href="next/rules.html#rule17">Rule 17</a>!</p>
 <h4 id="upload-your-entry-to-the-ioccc-submit-server">5. Upload your entry to the IOCCC submit server</h4>
-<p>The following steps should be taken:</p>
-<p>First, open the web page in your browser. It should look something like this:</p>
+<p>The following steps should be taken, in order to upload your <code>mkiocccentry</code> xz
+compressed tarball, to change the file (if you need to upload a different file
+or you have updated the submission), and to check the status of it after the
+contest closes:</p>
+<p>First, open the web page in your browser. It should look like this:
+With the login id and password already input, It should look something like
+this:</p>
 <p><img src="png/submit-server-login.png"
  alt="submit server login screen"
- width=566 height=609></p>
-<p>At this point, using the UUID login and the password you were provided with step
-0, log in. Assuming everything is fine, you should see something like:</p>
-<p><img src="png/submit-server-passwd.png"
+ width=710 height=562></p>
+<p>The login is the UUID you were provided when you registered for the IOCCC and
+the password is the initial password you were provided with. Click “Login”.
+Assuming everything is fine, it should look something like:</p>
+<p><img src="png/submit-server-first-login.png"
  alt="submit server password change required"
- width=566 height=854></p>
-<p>At this point you should change your password. Once this is done, you will have
-to log in again:</p>
+ width=710 height=808></p>
+<p>As you can see, you have to change your password. Put in your login (UUID
+username), your old (initial) password and a new password. For instance:</p>
+<p><img src="png/submit-server-change-passwd.png"
+ alt="submit server changing password"
+ width=710 height=808></p>
+<p>Click “Change Password”.</p>
+<p>Once this is done, you will have to log in again. Using the UUID login and the
+new password:</p>
 <p><img src="png/submit-server-passwd-changed.png"
  alt="submit server password changed"
- width=566 height=854></p>
-<p>At this point, enter your UUID login and new password, and then click “Login”.
-You will see submit slots. Each slot is for one submission so if you update a
-submission, make sure you choose the right one so you do not overwrite the wrong
-one. In this next screenshot you will see slot 0 is already
-selected:</p>
+ width=710 height=344></p>
+<p>.. click “Login”.</p>
+<p>Once you’ve logged in, you will see submit slots. Each slot is for one
+submission so if you update a submission, make sure you choose the right one so
+you do not overwrite the wrong one!</p>
+<p>Here is what it looks like without any uploads and no slot selected:</p>
 <p><img src="png/submit-server-slots.png"
- alt="submit server upload screen"
- width=566 height=905></p>
-<p>Further down the page you should see something like:</p>
-<p><img src="png/submit-server-file-select.png"
- alt="submit server file select"
- width=566 height=312></p>
-<p>Click the link to upload your <code>mkiocccentry</code> compressed tarball. For instance:</p>
-<p><img src="png/submit-server-file-selected.png"
- alt="submit server file selected"
- width=566 height=300></p>
-<p>Click “Submit”. Once it’s uploaded, you should be presented with a new screen.
-If you chose slot 0 you might see something like:</p>
+ alt="submit server slots"
+ 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-server-slot-file.png"
+ alt="submit server slot and file selected"
+ 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-server-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><img src="png/submit-server-submission-uploaded.png"
- alt="submit server file uploaded"
- width=566 height=574></p>
-<p>After the submission deadline is reached, and after the judges have verified
-that your submission is valid (as in passes the tools checks), you should see
-something like this:</p>
+ alt="submit server submission uploaded"
+ width=717 height=525></p>
+<p>Here you see the details, in particular:</p>
+<ul>
+<li>the status of the submission</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="next/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>
+</ul>
+<p>Now if you’re done, log out.</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
+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-server-status-updated.png"
- alt="submit server file uploaded"
- width=696 height=179></p>
+ alt="submit server status updated"
+ width=717 height=217></p>
+<p>For details on <code>txzchk</code>, see the
+FAQ on “<a href="#txzchk">txzchk</a>”.</p>
+<p>For details on <code>chkentry</code>, see the
+FAQ on “<a href="#chkentry">chkentry</a>”.</p>
+<p>If you need more information on what <code>chkentry</code> checks, see the
+FAQ on the <a href="#info_json">“.info.json file</a>”
+and the
+FAQ on the “<a href="#auth_json">.auth.json file</a>”.</p>
 <p>Jump to: <a href="#">top</a></p>
 <div id="what_mkiocccentry">
 <div id="mkiocccentry">

faq.md

@@ -271,65 +271,112 @@ See also [Rule 17](next/rules.html#rule17)!
 
 #### 5. Upload your entry to the IOCCC submit server
 
-The following steps should be taken:
+The following steps should be taken, in order to upload your `mkiocccentry` xz
+compressed tarball, to change the file (if you need to upload a different file
+or you have updated the submission), and to check the status of it after the
+contest closes:
 
-First, open the web page in your browser. It should look something like this:
+First, open the web page in your browser. It should look like this:
+With the login id and password already input, It should look something like
+this:
 
 <img src="png/submit-server-login.png"
  alt="submit server login screen"
- width=566 height=609>
+ width=710 height=562>
 
-At this point, using the UUID login and the password you were provided with step
-0, log in. Assuming everything is fine, you should see something like:
+The login is the UUID you were provided when you registered for the IOCCC and
+the password is the initial password you were provided with. Click "Login".
+Assuming everything is fine, it should look something like:
 
-<img src="png/submit-server-passwd.png"
+<img src="png/submit-server-first-login.png"
  alt="submit server password change required"
- width=566 height=854>
+ width=710 height=808>
 
-At this point you should change your password. Once this is done, you will have
-to log in again:
+As you can see, you have to change your password. Put in your login (UUID
+username), your old (initial) password and a new password. For instance:
+
+<img src="png/submit-server-change-passwd.png"
+ alt="submit server changing password"
+ width=710 height=808>
+
+Click "Change Password".
+
+Once this is done, you will have to log in again. Using the UUID login and the
+new password:
 
 <img src="png/submit-server-passwd-changed.png"
  alt="submit server password changed"
- width=566 height=854>
+ width=710 height=344>
 
-At this point, enter your UUID login and new password, and then click "Login".
-You will see submit slots. Each slot is for one submission so if you update a
-submission, make sure you choose the right one so you do not overwrite the wrong
-one. In this next screenshot you will see slot 0 is already
-selected:
+
+.. click "Login".
+
+Once you've logged in, you will see submit slots. Each slot is for one
+submission so if you update a submission, make sure you choose the right one so
+you do not overwrite the wrong one!
+
+Here is what it looks like without any uploads and no slot selected:
 
 <img src="png/submit-server-slots.png"
- alt="submit server upload screen"
- width=566 height=905>
+ alt="submit server slots"
+ width=710 height=806>
 
-Further down the page you should see something like:
+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-server-slot-file.png"
+ alt="submit server slot and file selected"
+ width=717 height=865>
 
-<img src="png/submit-server-file-select.png"
- alt="submit server file select"
- width=566 height=312>
+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:
 
-Click the link to upload your `mkiocccentry` compressed tarball. For instance:
+<img src="png/submit-server-change-file.png"
+ alt="submit server change file"
+ width=717 height=865>
 
-<img src="png/submit-server-file-selected.png"
- alt="submit server file selected"
- width=566 height=300>
+Once you're certain you have selected the correct file, click "Submit", below
+the file selection step.
 
-Click "Submit". Once it's uploaded, you should be presented with a new screen.
-If you chose slot 0 you might see something like:
+When it's uploaded it should look something like this:
 
 <img src="png/submit-server-submission-uploaded.png"
- alt="submit server file uploaded"
- width=566 height=574>
+ alt="submit server submission uploaded"
+ width=717 height=525>
 
-After the submission deadline is reached, and after the judges have verified
-that your submission is valid (as in passes the tools checks), you should see
-something like this:
+Here you see the details, in particular:
+
+- the status of the submission
+- 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](next/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
+
+Now if you're done, log out.
+
+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
+that your tarball / submission has been validated (NOT judged), by `txzchk(1)`
+and `chkentry(1)`.:
 
 <img src="png/submit-server-status-updated.png"
- alt="submit server file uploaded"
- width=696 height=179>
+ alt="submit server status updated"
+ width=717 height=217>
+
+For details on `txzchk`, see the
+FAQ on "[txzchk](#txzchk)".
+
+For details on `chkentry`, see the
+FAQ on "[chkentry](#chkentry)".
+
+If you need more information on what `chkentry` checks, see the
+FAQ on the [".info.json file](#info_json)"
+and the
+FAQ on the "[.auth.json file](#auth_json)".
 
 Jump to: [top](#)