306 Commits
Author SHA1 Message Date
Landon Curt Noll 0aff81f35e improve and expand submit text, use 00.00 as a sample UUID 2025-03-03 13:06:43 -08:00
Cody Boone Ferguson 7aa9ac3ecf Fix comments in all rule of Makefile.example
Without the @ before the comments (which are informative and to be
removed by contestants) it shows the comments when running 'make'. Even
worse is without doing $${CHMOD} it would not evaluate to anything so it
looked bizarre.

Thus the @ was added to the comments like the rest of the file (comments
in rules).
2025-03-03 09:38:45 -08:00
Cody Boone Ferguson a2d0f1abc0 Fix formatting in next/submit.html 2025-03-03 06:52:54 -08:00
Cody Boone Ferguson 04fdea9a14 Update register/submit/pw-change for screenreaders
The three important files, next/{register,submit,pw-change}.{md,html}
no longer have images in them (besides the logo at the top of the image
which has nothing to do with registering, submitting or changing
passwords); instead the text in the images are actual text (in some
cases, just the relevant parts and in others all or almost all).

The png/register.* and png/submit.* images were removed.
2025-03-03 05:14:35 -08:00
Landon Curt Noll 69cfd2122e fixed use of CA flags 2025-03-02 13:54:42 -08:00
Cody Boone Ferguson a4fd6f45d3 Update pw-change.html, register.html, submit.html
Some images are no longer used but they still exist here for the time
being. Text is used instead though based on some discussion text might
have to change.

Adjusted alt text of some images a bit.

A more thorough look at the way these updates look must still be done.
2025-03-02 13:24:28 -08:00
Landon Curt Noll e0f695c1a5 improve invalid password selection text 2025-03-02 03:56:56 -08:00
Cody Boone Ferguson da9064d95b Fixes in rules
This includes the FAQ as there is an FAQ about Rule 17.
2025-03-01 14:37:13 -08:00
Cody Boone Ferguson f2ac299a09 Update screenshots and files that reference them
The screenshots are more recent (including some new ones).

The welcome email images have not been updated as some things have to be
answered before that can be done.

The current files were renamed to be shorter as well.
2025-03-01 12:43:57 -08:00
Landon Curt Noll bf6d0a3574 experiment to move much of Rule 17 text into an FAQ
In order simplify the write-up of the actual Rule 17
into a new FAQ 1.8.  The somewhat shorted Rule 17 text
now refers to checks performed by tools, encourages
their use, discourages their misuse (overriding limits),
and is easier to read: we think.
2025-03-01 01:42:21 -08:00
Landon Curt Noll 6f06d1f441 fix markdown / html typo in rules 2025-03-01 00:56:25 -08:00
Landon Curt Noll fb5524e4ca made minor tweaks to the rules 2025-03-01 00:02:01 -08:00
Landon Curt Noll fadb1dde0d resolve issue #57
Moved information about the fields of `status.json` to FAQ 10.11.
2025-02-28 22:46:36 -08:00
Landon Curt Noll 84997f669b Merge pull request #101 from xexyl/chkentry
Update FAQ, guidelines and quick start
2025-02-27 18:05:12 -08:00
Cody Boone Ferguson 65cf447087 Update FAQ, guidelines and quick start
This addresses most (if not all) of the recent changes to chkentry(1)
though a more thorough check will be made later after the mkiocccentry
code freeze.
2025-02-27 14:56:01 -08:00
Landon Curt Noll b36623bde7 update via make www as per recent changes 2025-02-27 13:15:04 -08:00
Cody Boone Ferguson 9613ef6f9a Fix link in guidelines 2025-02-26 12:24:43 -08:00
Cody Boone Ferguson 664a7b57bd Various updates/fixes for recent chkentry mods 2025-02-26 12:20:55 -08:00
Landon Curt Noll 7aea6ba1f7 update the rules and guidelines versions 2025-02-12 16:56:10 -08:00
Landon Curt Noll 8f98b877fb update IOCCC28 open and judging dates
The IOCCC28 will now open on **2025-03-05 23:19:17.131107 UTC**
and enter the judging state on **2025-06-05 04:03:02.010099 UTC**.

Updated sitemap, added news for 2025-02-12, and updated the status.

Performed `make www gen_status gen_sitemap timestamp` on macOS to complete the above.
2025-02-12 16:40:36 -08:00
Cody Boone Ferguson 43574e6f05 Minor fixes in FAQ and guidelines
The FAQ stated (due to a mistake in the issue in the mkiocccentry repo)
that the submission directory (under workdir) has the timestamp in it
but that is not true. Instead the tarball filename has the timestamp.

Typo fix in guidelines.
2025-02-10 15:49:48 -08:00
Cody Boone Ferguson 1c5f14f3e0 More updates to FAQ for mkiocccentry process
Missing steps were added and other things which have changed (fixed)
have also bee noted.

There was also a typo fix in the rules.
2025-02-10 13:28:41 -08:00
Cody Boone Ferguson c6e1c09401 Update FAQ and rules for mkiocccentry
Additional things were added to the process (and as for the rules it
notes that remarks.md is only checked for size > 0, not that it has
content).
2025-02-08 10:34:24 -08:00
Cody Boone Ferguson d2c6b42078 Add important note about mkiocccentry execution
It is highly recommended that you run the tool from either the repo
directory itself (making sure you have the most up to date version of
course) or make sure you have installed it (also making sure you have
the most recent version). Not doing this will cause issues with checks
and in the case of out of date versions the submission would be rejected
due to violating rule 17. One can specify the options to mkiocccentry
for the tools required but if you forget or don't have the most up to
date version you will very likely run into problems.
2025-02-06 10:13:53 -08:00
Cody Boone Ferguson a2e216ec82 Update rules, guidelines and FAQ for file perms
Rule 17 mandates specific file permissions for files/directories in
submission tarballs but the documentation did not state this. More work
might need to be done here but it should be better now.
2025-02-03 07:43:52 -08:00
Cody Boone Ferguson b0f512b865 chmod +x next/try.sh and next/try.alt.sh 2025-02-02 12:41:24 -08:00
Cody Boone Ferguson 5e5dacfb5c Add to Makefile.example note about +x
Since only try.sh and try.alt.sh files may be executable in submission
tarballs, the Makefile.example now notes this and shows how one can
adjust this if they need to. This is also in the guidelines, rules and
FAQ but those cannot be committed yet.
2025-02-02 12:37:38 -08:00
Cody Boone Ferguson 52deabd02a Add remarks.example.md, update FAQ/guidelines
The next/remarks.example.md filename is kind of a misnomer but it was
named this way to match Makefile.example. It has brief instructions
along with a link to the FAQ about what one should put in their
remarks.md file (and the FAQ links to the new file as a starting point
as it has instructions).

The markdown guidelines were updated to note that if one does use
sections in remarks.md file they should start out at heading level 3
(###) and for each subsection increment it by one (up to level 6).
2025-02-02 10:16:35 -08:00
Cody Boone Ferguson 68b9b5983c Break up text about required files in guidelines
This should (hopefully) make it easier to read.
2025-01-30 12:10:38 -08:00
Cody Boone Ferguson db6fd9ab66 Update FAQ, guidelines and rules
The new syntax (though not all functionality is yet finished) of
mkiocccentry does not match what was in the FAQ, guidelines and rules.

Also added an important reminder to use v7 format with tarballs as not
doing so can reveal who you are which would break the rules. This is
mentioned in the rules and guidelines, showing how to create such a
tarball.

More work does have to be done with these two things however.
2025-01-30 11:43:00 -08:00
Cody Boone Ferguson 16c5ca3896 Add note about test-suites to guidelines
This was discussed a while back but it was never added to the
guidelines.
2025-01-30 11:14:09 -08:00
Cody Boone Ferguson 5f9aac278f Various typos in news/guidelines/rules 2025-01-25 09:56:15 -08:00
Landon Curt Noll 8db0e0a5dd change the contest open date range, a discord server news
The IOCCC now has a [Discord server](https://discord.gg/2hVYnv83DD)!
Click the link to join the [IOCCC Discord server](https://discord.gg/2hVYnv83DD).
Fans of the IOCCC, hopeful **IOCCC28** contestants, and past winners of the IOCCC
are all encouraged to stop by and say hello.

Based on user input and suggestions, we have been working on some new
functionality for the [mkiocccentry tool set](faq.html#mkiocccentry).
In order to complete and fully test this new functionality, we need
additional time.  Therefore the **IOCCC28 open** date as been **moved
forward for 19 days**.  Moreover, and also by request, the contest will
remain **open for an additional month**.

The [40th anniversary of the IOCCC](faq.html#ioccc_start), which started
on **2024-12-29 23:58:13.213455 UTC**, is now scheduled to be **open**
from **2025-02-19 23:19:17.130705 UTC** to **2025-05-19 23:29:31.374143
UTC**.  We will update the [IOCCC rules](next/rules.html) and
[IOCCC guidelines](next/guidelines.html) accordingly, before the contest opens.
2025-01-24 21:47:44 -08:00
Cody Boone Ferguson 7ef8df9e49 Typo fix in guidelines link 2025-01-23 12:13:25 -08:00
Cody Boone Ferguson 03b4248dd2 Many fixes and other updates to guidelines
This includes typos, fixing terms (according to the new terminology used
by the IOCCC) and various other types of fixes.

Although I have gone through the entire file more does need to be done
to make sure it all reads okay and that all links are correct.
2025-01-23 12:06:56 -08:00
Cody Boone Ferguson 065bd090cd More clarification in guidelines wrt rule 17 2025-01-23 07:36:32 -08:00
Cody Boone Ferguson 4a01bfc58a Clarify clobber rule in guidelines wrt rule 17 2025-01-23 07:26:35 -08:00
Cody Boone Ferguson eda967ff60 Clarification and additions in guidelines
Reworded some things.

Brought up how the IOCCC has moved away from spoilers.

As part of the section on the Makefile I have additionally added to the
Makefile.example a 'try.alt' rule in the case of someone having
alternate code. It is not required, of course.
2025-01-22 09:59:03 -08:00
Cody Boone Ferguson f241a72cb7 Fix broken links in guidelines 2025-01-18 09:39:51 -08:00
Cody Boone Ferguson b65e85678f Add details on submitting extra files
The FAQ, guidelines and rules have been updated to reflect recent
discussions and modifications to the maximum number of files.

A new FAQ entry has been added. The guidelines talk about including
extra tarballs and rule 17 has been updated as well. Some of this was
copied directly from discussion with Landon.

Some minor other fixes were made in the guidelines and rules (mostly
wording).
2025-01-18 09:05:58 -08:00
Cody Boone Ferguson 220864ac2d Fix Makefile.example - add missing variables
Winning entries include var.mk and that sets the variables CLANG and
GCC. Without this the findstring check in the Makefile (on ${CC})
matches the first one and uses the wrong warning options.

This commit resolves this problem.
2025-01-17 09:38:15 -08:00
Cody Boone Ferguson 3626027455 Add details about -s seed/-d to FAQ and guidelines 2025-01-16 11:32:32 -08:00
Cody Boone Ferguson 2c3514ec3f Clarify a statement in next/Makefile.example
One should not remove the ALT_OBJ or ALT_TARGET lines but rather the
comments about them (that explain to submitters how to use them).
2025-01-16 06:31:14 -08:00
Landon Curt Noll c075bca287 improve the next/Makefile.example
Removed use of @${TRUE} in make actions.

Use `${PROG}.c` and `${PROG}.alt.c` in compile actions.
2025-01-12 23:07:51 -08:00
Landon Curt Noll 728af35143 remove reference to Makefile.example from the other repo 2025-01-12 19:32:24 -08:00
Cody Boone Ferguson 695b587da3 Typo fix in rules and guidelines
This includes the include files inc/guidelines.pending.hdr and
inc/rules.pending.hdr.

Rebuilt html files as well.

This does not include the other pending fixes and it does not include
the updates about mkiocccentry now allowing subdirectories. That'll come
in another commit either later today or if not then hopefully this
weekend.
2025-01-10 06:02:50 -08:00
Landon Curt Noll 11dfe51c6c move IOCCC Quick Start Guide
Created `quick-start.md` to hold the FAQ 0.0 content.

Used `sgit(1)` to change:

* faq.html#enter ==> quick-start.html#enter
* faq.html#enter_questions ==> quick-start.html#enter_questions
* faq.html#step_0 ==> quick-start.html#step_0
* faq.html#step_1 ==> quick-start.html#step_1
* faq.html#step_2 ==> quick-start.html#step_2
* faq.html#register ==> quick-start.html#register
* faq.html#step_3 ==> quick-start.html#step_3
* faq.html#step_4 ==> quick-start.html#step_4
* faq.html#step_5 ==> quick-start.html#step_5
* faq.html#step_6 ==> quick-start.html#step_6
* faq.html#step_7 ==> quick-start.html#step_7
* faq.html#step_submit ==> quick-start.html#step_submit

Via:

```sh
sgit -e 's/faq\.html#enter/quick-start.html#enter/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#enter_questions/quick-start.html#enter_questions/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_0/quick-start.html#step_0/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_1/quick-start.html#step_1/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_2/quick-start.html#step_2/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#register/quick-start.html#register/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_3/quick-start.html#step_3/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_4/quick-start.html#step_4/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_5/quick-start.html#step_5/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_6/quick-start.html#step_6/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_7/quick-start.html#step_7/g' '*.md' '*.hdr' 'inc/*.html'
sgit -e 's/faq\.html#step_submit/quick-start.html#step_submit/g' '*.md' '*.hdr' 'inc/*.html'
```

The former FAQ 0.0 section in `faq.html` now just refers to `quick-start.html`.

Modified menu and non-JS menu so that "Enter the IOCCC" refers to `quick-start.html`.

Changed `bin/gen-top-html.sh` VERSION from "1.4.10 2024-11-23"
to "1.4.11 2025-01-09".

Performed `make www` on macOS to complete the above.
2025-01-09 23:11:43 -08:00
Cody Boone Ferguson 8197b62e5b Make IOCCC status text consistent with JSON status
The status showed 'The IOCCC is not yet open' to indicate it is in
pending status. But it would be better to match the actual status
itself especially as the status.html file explains pending status, not
'not yet open'. At a quick glance it is easy to miss especially for
those of us who have worked on the repo for a long time and in
particular those who worked on the status.html file a lot.

This updated files in inc/, bin/ and next/ but I cheated and used sgit
to do this. I then rebuilt the html files. A previous minor grammar
problem in rules was fixed as well.
2024-12-31 11:22:29 -08:00
Landon Curt Noll ecf1143edf fix Important IOCCC dates section with Rule 0 2024-12-31 00:11:16 -08:00
Landon Curt Noll b33f9333b3 update Rule 0 so that is includes the Important IOCCC dates 2024-12-31 00:05:58 -08:00