From ea5af46861650af6355445ce0149632c5a733966 Mon Sep 17 00:00:00 2001 From: Landon Curt Noll Date: Wed, 25 Dec 2024 01:30:40 -0800 Subject: [PATCH] improve register.html We added lettered steps to `next/register.md` as part of our configuring the mailing list for IOCCC28. Change "IOCCC Judges" to the more commonly used "IOCCC judges" and made it a HTML link in `2014/README.md`, `2015/README.md`, and `faq.md`. Added a reference to "first time login" in `next/submit.md`. Improved some text in Step 3 of FAQ 0.0 of `faq.md`. Performed `make quick_www` to update the HTML pages. TODO: Need to add images to the lettered steps in `next/register.md. --- 2014/README.md | 2 +- 2014/index.html | 2 +- 2015/README.md | 2 +- 2015/index.html | 2 +- faq.html | 17 +++-- faq.md | 19 ++++-- next/guidelines.html | 2 +- next/guidelines.md | 2 +- next/register.html | 103 +++++++++++++++++++++++++++--- next/register.md | 149 ++++++++++++++++++++++++++++++++++++++++--- next/rules.html | 2 +- next/rules.md | 2 +- next/submit.html | 6 +- next/submit.md | 4 ++ 14 files changed, 274 insertions(+), 40 deletions(-) diff --git a/2014/README.md b/2014/README.md index ddb1b1f28..b5d7e32a8 100644 --- a/2014/README.md +++ b/2014/README.md @@ -98,7 +98,7 @@ us a line. We enjoy seeing who, where and how the contest is used. If you have problems with any of the entries, AND YOU HAVE A FIX, please send us the fix (patch file or the entire changed file). -For the latest information on how to contact the IOCCC Judges please visit +For the latest information on how to contact the [IOCCC judges](../judges.html) please visit * [contact.html](../contact.html) diff --git a/2014/index.html b/2014/index.html index 3c19f8321..5ddf972f8 100644 --- a/2014/index.html +++ b/2014/index.html @@ -496,7 +496,7 @@ future contests.

us a line. We enjoy seeing who, where and how the contest is used.

If you have problems with any of the entries, AND YOU HAVE A FIX, please send us the fix (patch file or the entire changed file).

-

For the latest information on how to contact the IOCCC Judges please visit

+

For the latest information on how to contact the IOCCC judges please visit

diff --git a/2015/README.md b/2015/README.md index f26db9b78..39f741bb3 100644 --- a/2015/README.md +++ b/2015/README.md @@ -104,7 +104,7 @@ us a line. We enjoy seeing who, where and how the contest is used. If you have problems with any of the entries, AND YOU HAVE A FIX, please send us the fix (patch file or the entire changed file). -For the latest information on how to contact the IOCCC Judges please visit +For the latest information on how to contact the [IOCCC judges](../judges.html) please visit * [contact.html](../contact.html) diff --git a/2015/index.html b/2015/index.html index 7b85e8043..8f11aa316 100644 --- a/2015/index.html +++ b/2015/index.html @@ -504,7 +504,7 @@ future contests.

us a line. We enjoy seeing who, where and how the contest is used.

If you have problems with any of the entries, AND YOU HAVE A FIX, please send us the fix (patch file or the entire changed file).

-

For the latest information on how to contact the IOCCC Judges please visit

+

For the latest information on how to contact the IOCCC judges please visit

diff --git a/faq.html b/faq.html index c9f5ab95f..4d6f518b4 100644 --- a/faq.html +++ b/faq.html @@ -613,12 +613,15 @@ visit the How to register for the IOCCC for det

3. Obtain and compile the latest mkiocccentry toolkit

-

You MUST use the most recent version of the mkiocccentry toolkit. To help -you, please see the -FAQ on “how to obtain the most recent mkiocccentry” -and the -FAQ on “compiling mkiocccentry toolkit”, -for more details.

+

Once the contest is open, download the most recent +version of the mkiocccentry toolkit.

+

IMPORTANT NOTE: While the contest is pending, +the mkiocccentry toolkit +could change. Once the content is open, be sure +you have the latest version installed.

+

To help you, please see the FAQ on “how to obtain the most recent +mkiocccentry” and the FAQ on “compiling +mkiocccentry toolkit”, for more details.

4. Run the mkiocccentry tool to form your submission tarball

@@ -4983,7 +4986,7 @@ we request that you ask the IOCCC judges first. Of cou you’re the winner of the entry you can make use of it as you want (make a shirt, put it on your website etc.).

Please send your request using the instructions on the contacting -the IOCCC Judges page.

+the IOCCC judges page.

Please note that the content of the IOCCC Copyrighted and is under the CC BY-SA 4.0 License. See the Copyright at the bottom of IOCCC web pages for more details.

diff --git a/faq.md b/faq.md index bc4581fbe..1b28a0031 100644 --- a/faq.md +++ b/faq.md @@ -211,12 +211,17 @@ visit the [How to register for the IOCCC](next/register.html) for detailed instr #### 3. Obtain and compile the latest mkiocccentry toolkit -You **MUST** use the most recent version of the `mkiocccentry` toolkit. To help -you, please see the -FAQ on "[how to obtain the most recent mkiocccentry](#obtaining_mkiocccentry)" -and the -FAQ on "[compiling mkiocccentry toolkit](#compiling_mkiocccentry)", -for more details. +Once the contest is [open](status.html#open), download the most recent +version of the [mkiocccentry toolkit](https://github.com/ioccc-src/mkiocccentry). + +**IMPORTANT NOTE**: While the contest is [pending](status.html#pending), +the [mkiocccentry toolkit](https://github.com/ioccc-src/mkiocccentry) +could change. Once the content is [open](status.html#open), be sure +you **have the latest** version installed. + +To help you, please see the FAQ on "[how to obtain the most recent +mkiocccentry](#obtaining_mkiocccentry)" and the FAQ on "[compiling +mkiocccentry toolkit](#compiling_mkiocccentry)", for more details.
@@ -6189,7 +6194,7 @@ you're the winner of the entry you can make use of it as you want (make a shirt, put it on your website etc.). Please send your request using the instructions on the [contacting -the IOCCC Judges](contact.html) page. +the IOCCC judges](contact.html) page. Please note that the content of the IOCCC **Copyrighted and is under the CC BY-SA 4.0 License**. diff --git a/next/guidelines.html b/next/guidelines.html index c05aaa2fd..f6325c530 100644 --- a/next/guidelines.html +++ b/next/guidelines.html @@ -1211,7 +1211,7 @@ removed by the clobber rule.

We LIKE submissions that use an edited variant of the example Makefile, as described and linked to in the Makefile section, -renamed as Makefile of course. This makes it easier for the IOCCC Judges +renamed as Makefile of course. This makes it easier for the IOCCC judges to test your submission. And if your submissions wins, it makes it easier to integrate it into the Official IOCCC winner website.

diff --git a/next/guidelines.md b/next/guidelines.md index 33ca7876a..1892607c2 100644 --- a/next/guidelines.md +++ b/next/guidelines.md @@ -1003,7 +1003,7 @@ Jump to: [top](#)

We **LIKE** submissions that use an edited variant of the example Makefile, as described and linked to in the [Makefile section](#makefile), -renamed as `Makefile` of course. This makes it easier for the [IOCCC Judges](../judges.html) +renamed as `Makefile` of course. This makes it easier for the [IOCCC judges](../judges.html) to test your submission. And if your submissions wins, it makes it easier to integrate it into the [Official IOCCC winner website](https://www.ioccc.org/index.html).

diff --git a/next/register.html b/next/register.html index bcfc741c4..4d719d2b7 100644 --- a/next/register.html +++ b/next/register.html @@ -424,14 +424,101 @@ -

How to register for the IOCCC

-

First, be sure the contact contest status allows you to register. -The contest needs to be either pending or open. -For details see the section titled How the contest status impacts registration.

-

XXX - put images and other details about joining the mailing list here - XXX

-

NEXT: After registering for the IOCCC, you need to complete +

+

Step A: Verify that the contest pending or open

+
+

The contest needs to be either pending or open +in order to register for the IOCCC.

+

For details see the “How the contest status impacts registration” section below.

+
+

Step B: Enter your email address

+
+ +

NOTE: For submissions with multiple authors, only one author needs to subscribe.

+
+ +
+

Look for an automated email message from the FreeLists List Manager (ecartis@freelists.org).

+

The email message will have the subject:

+
Subscription consent for 'ioccc28-reg'
+

NOTE: The “Subscription consent” email is usually send by the FreeLists +List Manager within a minute after clicking the ((Next >>)) button. +If you don’t see the “Subscription consent” email, check your spam folder.

+

NOTE: If are having trouble receiving the “Subscription consent” +email, Contact the IOCCC, and you have tried +several times, ask the IOCCC judges for assistance.

+
+ +
+

This email will contain a URL of the form: http://www.freelists.org/v/ioccc28-reg/SOME-RANDOM-STUFF

+

Click on that link.

+

NOTE: If you prefer to NOT click links in email, simply copy that +URL from your “Subscription consent email” and paste it into your browser.

+
+

Step E: Confirm your email click

+
+

In your browser, for the link referenced in Step D, click the ((Next >>)) button.

+
+

Step F: Content and Verify

+
+

The FreeLists service that you verify that you:

+ +

Once you have done this by clicking the 3 checkboxes, the ((Next >>)) button.

+
+

Step G: Read the Welcome email

+
+

You receive an automated Welcome message from the FreeLists List Manager +(ecartis@freelists.org) with the subject:

+
Welcome to 'ioccc28-reg'
+

Read the “Welcome” email.

+

NOTE: The “Welcome” email is usually send by the FreeLists +List Manager within a minute after clicking the ((Next >>)) button. +If you don’t see the “Subscription consent” email, check your spam folder.

+

NOTE: If are having trouble receiving the “Welcome” email, +Contact the IOCCC, and you have tried +several times, ask the IOCCC judges for assistance.

+
+

Step H: Receive your Username and Initial Password

+
+

Assuming that the contest is open, one of the IOCCC judges +will send via email, your initial IOCCC submit server Username +and Initial password. This could take up to a few days, so please be patient.

+

IMPORTANT NOTE: Unless the contest is open, the +IOCCC judges will NOT be sending out your +initial IOCCC submit server username and initial password.

+

For example, if contest is pending, you will +have to wait until the IOCCC judges will WAIT UNTIL +THE CONTEST IS OPEN before sending such email.

+

NOTE: If are having trouble receiving your Username and +Initial password, and the CONTEST IS OPEN, +and you checked your spam folder, Contact the IOCCC for assistance.

+
+

Step I: Login to the submit server and change your password

+
+

Using the Username and Initial password from step H, login +to the IOCCC submit server WITHIN 72 HOURS +(of when one of the IOCCC judges sent that email) to change +your password.

+

See How upload your submission to the IOCCC for details +on how to change your Initial password.

+

IMPORTANT NOTE: If you do not change your Initial password within +72 hours of when one of the IOCCC judges sent that email, +you will have to re-register for the IOCCC.

+
+

Step J: Proceed with step 3

+
+

When the is open, proceed with Step 3: Obtain and compile the latest mkiocccentry toolkit.

How the contest status impacts registration

@@ -445,12 +532,12 @@ or open.

When the IOCCC status is pending

While the contest is PEDING, you may **register for contest*, however you will NOT -receive your own Email message containing your IOCCC submit server +receive your own email message containing your IOCCC submit server Username and Initial Password until the IOCCC is open.

When the IOCCC status is open

While the contest is OPEN, you may register for the contest. Once you are registered AND -the contest is open, you will receive your own Email message containing your very own +the contest is open, you will receive your own email message containing your very own Username and Initial Password until the contest is open. You will need these to be able to upload your submission to the IOCCC submit server.

See also the diff --git a/next/register.md b/next/register.md index 6a275dc84..5d9d8f486 100644 --- a/next/register.md +++ b/next/register.md @@ -1,14 +1,147 @@ -

# How to register for the IOCCC
-First, be sure the contact [contest status](../status.html) allows you to register. -The contest needs to be either [pending](../status.html#pending) or [open](../status.html#open). -For details see the section titled [How the contest status impacts registration](#status_impact). -XXX - **put images and other details about joining the mailing list here** - XXX +
+## Step A: Verify that the contest pending or open +
-**NEXT**: After registering for the IOCCC, you need to complete +The contest needs to be either [pending](../status.html#pending) or [open](../status.html#open) +in order to register for the IOCCC. + +For details see the "[How the contest status impacts registration](#status_impact)" section below. + + +
+## Step B: Enter your email address +
+ +- Visit the [IOCCC28 registration page](https://www.freelists.org/list/ioccc28-reg) +- Enter your email address +- Select ((Subscribe)) +- Click the **((Next >>))** button + +**NOTE**: For submissions with multiple authors, only one author needs to subscribe. + + +
+## Step C: Look for the Subscription consent email from FreeLists +
+ +Look for an automated email message from the FreeLists List Manager (_ecartis@freelists.org_). + +The email message will have the subject: + +``` +Subscription consent for 'ioccc28-reg' +``` + +**NOTE**: The "Subscription consent" email is usually send by the FreeLists +List Manager within a minute after clicking the **((Next >>))** button. +If you don't see the "Subscription consent" email, check your spam folder. + +**NOTE**: If are having trouble receiving the "Subscription consent" +email, [Contact the IOCCC](../contact.html), and you have tried +several times, ask the [IOCCC judges](../judges.html) for assistance. + + +
+## Step D: Open the Subscription consent email message +
+ +This email will contain a URL of the form: http://www.freelists.org/v/ioccc28-reg/SOME-RANDOM-STUFF + +Click on that link. + +**NOTE**: If you prefer to **NOT** click links in email, simply copy that +URL from your "Subscription consent email" and paste it into your browser. + + +
+## Step E: Confirm your email click +
+ +In your browser, for the link referenced in [Step D](#step_d), click the **((Next >>))** button. + + +
+## Step F: Content and Verify +
+ +The FreeLists service that you verify that you: + +- Have read, understand, and agree to their "_Terms of Service_" +- Have read, understand, and agree to their "_Privacy Policy_" +- Are the owner or authorized user of the email you registered + +Once you have done this by clicking the 3 checkboxes, the **((Next >>))** button. + + +
+## Step G: Read the Welcome email +
+ +You receive an automated Welcome message from the FreeLists List Manager +(_ecartis@freelists.org_) with the subject: + +``` +Welcome to 'ioccc28-reg' +``` + +Read the "Welcome" email. + +**NOTE**: The "Welcome" email is usually send by the FreeLists +List Manager within a minute after clicking the **((Next >>))** button. +If you don't see the "Subscription consent" email, check your spam folder. + +**NOTE**: If are having trouble receiving the "Welcome" email, +[Contact the IOCCC](../contact.html), and you have tried +several times, ask the [IOCCC judges](../judges.html) for assistance. + + +
+## Step H: Receive your Username and Initial Password +
+ +Assuming that the contest is [open](../status.html#open), one of the [IOCCC judges](../judges.html) +will send via email, your initial [IOCCC submit server](https:/submit.ioccc.org) **Username** +and **Initial password**. This could take up to a **few days**, so **please be patient**. + +**IMPORTANT NOTE**: Unless the contest is [open](../status.html#open), the +[IOCCC judges](../judges.html) will **NOT** be sending out your +initial [IOCCC submit server](https:/submit.ioccc.org) username and initial password. + +For example, if contest is [pending](../status.html#pending), you will +have to wait until the [IOCCC judges](../judges.html) will **WAIT UNTIL +THE CONTEST IS [OPEN](../status.html#open)** before sending such email. + +**NOTE**: If are having trouble receiving your **Username** and +**Initial password**, and the **CONTEST IS [OPEN](../status.html#open)**, +and you checked your spam folder, [Contact the IOCCC](../contact.html) for assistance. + + +
+## Step I: Login to the submit server and change your password +
+ +Using the **Username** and **Initial password** from [step H](#step_h), login +to the [IOCCC submit server](https:/submit.ioccc.org) **WITHIN 72 HOURS** +(of when one of the [IOCCC judges](../judges.html) sent that email) to change +your password. + +See [How upload your submission to the IOCCC](submit.html) for details +on how to change your **Initial password**. + +**IMPORTANT NOTE**: If you do not change your **Initial password** within +72 hours of when one of the [IOCCC judges](../judges.html) sent that email, +you will have to **re-register for the IOCCC**. + + +
+## Step J: Proceed with step 3 +
+ +When the is [open](../status.html#open), proceed with [Step 3: Obtain and compile the latest mkiocccentry toolkit](../faq.html#step_3). @@ -31,7 +164,7 @@ or [open](../status.html#open). While the contest is **[PEDING](../status.html#pending)**, you may **register for contest*, however you will **NOT** -receive your own Email message containing your [IOCCC submit server](https:/submit.ioccc.org) +receive your own email message containing your [IOCCC submit server](https:/submit.ioccc.org) **Username and Initial Password until the IOCCC is [open](../status.html#open)**. @@ -39,7 +172,7 @@ receive your own Email message containing your [IOCCC submit server](https:/subm While the contest is **[OPEN](../status.html#open)**, you may **register for the contest**. Once you are registered **AND** -the contest is [open](../status.html#open), you will receive your own Email message containing your very own +the contest is [open](../status.html#open), you will receive your own email message containing your very own **Username and Initial Password until the contest is [open](../status.html#open)**. You will need these to be able to [upload your submission](submit.html) to the [IOCCC submit server](https:/submit.ioccc.org). diff --git a/next/rules.html b/next/rules.html index 60689a4ec..6650fc1b0 100644 --- a/next/rules.html +++ b/next/rules.html @@ -1040,7 +1040,7 @@ These checks MUST PASS.

Where Rule 17 and the tools from the latest release of the mkiocccentry repo -conflict, the IOCCC Judges will use their best judgment which +conflict, the IOCCC judges will use their best judgment which is likely to favor mkiocccentry repo code.

diff --git a/next/rules.md b/next/rules.md index 9e7bd1e54..f17b2cfdb 100644 --- a/next/rules.md +++ b/next/rules.md @@ -739,7 +739,7 @@ These checks **MUST PASS**.

Where [Rule 17](#rule17) and the tools from the latest release of the [mkiocccentry repo](https://github.com/ioccc-src/mkiocccentry) -conflict, the [IOCCC Judges](../judges.html) will use their best judgment which +conflict, the [IOCCC judges](../judges.html) will use their best judgment which is likely to favor [mkiocccentry repo](https://github.com/ioccc-src/mkiocccentry) code.

diff --git a/next/submit.html b/next/submit.html index e7256baad..ed4705911 100644 --- a/next/submit.html +++ b/next/submit.html @@ -443,8 +443,10 @@ this:

alt="submit server login screen" width=710 height=562>

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:

+the password is the initial password you were provided with. Click “Login”.

+

If this is the first time you have logged in with this UUID, you will +be required to change your password.

+

Assuming everything is fine, it should look something like:

submit server password change required

diff --git a/next/submit.md b/next/submit.md index bed57ed6b..5647715de 100644 --- a/next/submit.md +++ b/next/submit.md @@ -24,6 +24,10 @@ this: 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". + +If this is the first time you have logged in with this UUID, you will +be required to change your password. + Assuming everything is fine, it should look something like: