172 Commits
Author SHA1 Message Date
Landon Curt Noll 217dda5ddc set IOCCC state to pending
Fixed `#todo` link in `2024/macke/README.md`.

Improved markdown paragraph size of `inc/rules.*.hdr` files.

Fixed FAQ link generated by `bin/status2html.sh` for the pending state.
Improved the markdown written by `bin/status2html.sh` for various states.

Changed `bin/status2html.sh` VERSION to "2.0.2 2025-12-02".

Changed IOCCC Rules to version **29.15 2025-12-01**.
Changed IOCCC Guidelines to version **29.08 2025-12-02**.
Changed IOCCC FAQ to version **29.05 2025-12-02**..

Ran `make update` to perform the above.
2025-12-02 21:38:04 -08:00
Cody Boone Ferguson d7be1bd8b4 Fixes in guidelines
This includes a number of blocks of text in the wrong place.

Some typos were fixed but just like with the rules a very thorough job
was not done and there are deliberate typos in the guidelines as well.
It should be a bit clearer now, except perhaps the guidelines that are
deliberately confusing (or those I missed).
2025-12-02 10:50:01 -08:00
Cody Boone Ferguson 4d826df0f5 Remove problematic link in guidelines
The text was actually already there (as I thought since I had added it
some days back).
2025-12-02 05:57:56 -08:00
Cody Boone Ferguson 247c06c22b Fix link in guidelines.html (to 2024/index.html) 2025-12-02 05:49:06 -08:00
Cody Boone Ferguson 94f96d7ef9 Final fixes for IOCCC guidelines/rules
Fixed broken links.

Restored text that was accidentally removed during the emergency
recovery of guidelines some days back.

Moved some text that was in the wrong place.

The formatting of the markdown files was changed for shorter lines (for
those viewing the markdown in a viewer rather than a web browser).

Added a <div id> to 2024/index.html so the guidelines (or maybe rules)
could link to the important note from the judges in IOCCC28.

Restore rewording of rule 2b done by @SirWumpus.
2025-12-02 05:45:34 -08:00
Landon Curt Noll a3fb61a6bf improve PR #246 - part 2
Simplify link tags in rules and guidelines.

Ran `make quick_www` to perform the above.
2025-12-01 20:26:21 -08:00
Landon Curt Noll 8a95f0c6bb improve PR #246 - part 1
Fixed links between rules and guidelines.

Add guideline about "Rule 2 - Size restrictions" not changing soon.

Expand "Guidelines for Rule 13 - No carriage returns in prog.c".

Put the word, "restrictions" into "Rule 2 - Size restrictions".
While this is a **GOOD IDEA**, the concept needs to be rolled out
over all of the rules, not just "Rule 2 - Size restrictions".

Changed IOCCC Rules to version **29.13 2025-12-01**.
Changed IOCCC Guidelines to version **29.06 2025-12-01**.

Ran `make quick_www` to perform the above.
2025-12-01 19:53:23 -08:00
Anthony Howe e55b00bc4f Add more subsections and reorder paragrphs. 2025-12-01 17:56:25 -05:00
Anthony Howe 3001506016 Revise For More Information section to be similar to the Rules
Further Reading block.
2025-12-01 16:45:32 -05:00
Anthony Howe d1a8eadc7a Apply patch from Chongo. 2025-12-01 16:26:49 -05:00
Anthony Howe 05d418ce1e Create subsections for Likes & Dislikes as its very long and
unstructured and hard to find specific guidelines when scattered.
Add some rule guideline based from the general section.  Shuffle
related paragraphs under relevant sections.
2025-12-01 14:56:16 -05:00
Anthony Howe 3fb02186e4 Remove IOCCC where it should be obvious who the organisation is
and use a proper noun for an entity.
2025-12-01 14:51:42 -05:00
Anthony Howe 45bcbf63ec Fix link spelling. 2025-12-01 14:40:12 -05:00
Anthony Howe dfb9312305 Move rule 12 comment from general to guidelines about rules. 2025-12-01 14:40:12 -05:00
Landon Curt Noll 8fd8605c2e fix a few typos, clarify that SUS means 2025-12-01 04:25:39 -08:00
Landon Curt Noll 75387360d0 improve rules & guidelines
Added a number of change bars to the rules & guidelines.

Recommend recommend that all markdown files in your submission observe
[IOCCC markdown guidelines](../markdown.html).

Made use of "_..._" consistent in the rules & guidelines.

Updated some the fun guidelines.

Performed some whitespace cleanup in the rules & guidelines.

Changed IOCCC Rules to version **29.12 2025-12-01**.
Changed IOCCC Guidelines to version **29.04 2025-12-01**

Ran `make quick_www` to perform the above.
2025-12-01 02:27:06 -08:00
Landon Curt Noll eda2531e4d update rules & guidelines
Improved Rule 1.

Added Guidelines for Rule 1.

Improved Rule 3.

Added missing Guidelines for Rule 3.

Reordered guidelines sections under the "General Guidelines".

Set level 2 for "General Guidelines" subsections.

Changed IOCCC Rules to version **29.11 2025-11-30**.
Changed IOCCC Guidelines to version **29.03 2025-11-30**.

Ran `make quick_www` to perform the above.
2025-12-01 01:19:49 -08:00
Cody Boone Ferguson f3de2bdf14 Update FAQ and fix guidelines
The FAQ has a new item that is referred to in the guidelines updates.

The guidelines has some link fixes and other minor changes.

Some fun was corrected in the guidelines as well but kept a fair bit
shorter than before (i.e. shorter than IOCCC28). In particular because
some code from the mkiocccentry (from some contributors) is no longer
extant, and because said code was not even a complete program, only
refer to two programs that were strictly written by someone other than
the judges.  Those paragraphs are only one sentence (they used to be
more than one) and the rest of the mkiocccentry repos is not mentioned
(this was the longest one and it went into other things that while fun
were not relevant). This keeps it light, fun, very short and more
importantly correct both to the rule about submissions must be a
COMPLETE C program and other rules as well.

Some typo fixes were made.

I believe this commit resolves the problems from yesterday although I
did not go through the file extremely carefully as I know @SirWumpus
also wants to go through it and so does Landon, so I kind of rushed
through it.
2025-11-30 04:31:43 -08:00
Landon Curt Noll d53e0deffd fix some indenting issues, and bing! 2025-11-29 23:11:20 -08:00
Landon Curt Noll 21798a1005 fix RTFS guideline :-) 2025-11-29 22:54:51 -08:00
Landon Curt Noll 4256b02327 checkpoint guideline fixes
Attempt to fix HTML5 errors.

Remove Makefile section from Guidelines as
this is in the FAQ.

Added links to Makefile FAQ in Guidelines.

Ran `make quick_www` to perform the above

TODO: Complete the correction for issue #244 ("Restore guidelines").

TODO: Continue to revise and improve the IOCCC guidelines as needed.

TODO: Fix typos/nits in the `next/guidelines.md` if needed.

TODO: Fix typos/nits in the `next/rules.md` if needed.
2025-11-29 17:35:58 -08:00
Landon Curt Noll c5bd5b33a4 fix guidelines, remove guideline status, update sitemap
This is a checkpoint correction for issue #244 ("Restore guidelines")
which in turn was a correction for issue #243 ("Fixes and minor
improvements in rules").

Remove code that put the contest status at the top
of the guidelines page.

Change `bin/gen-status.sh` VERSION to "2.1.0 2025-11-29",

Fix `next/guidelines.md` so that `next/guidelines.html`
is rendered correctly.

Update sitemap and status (due to recent news mod).

Ran `make quick_www` to perform the above

TODO: Complete the correction for issue #244 ("Restore guidelines").

TODO: Continue to revise and improve the IOCCC guidelines as needed.

TODO: Fix typos/nits in the `next/guidelines.md` if needed.

TODO: Fix typos/nits in the `next/rules.md` if needed.
2025-11-29 16:57:37 -08:00
Cody Boone Ferguson 41b3513422 Restore guidelines
Somehow the guidelines got clobbered during an edit. It is not clear to
me if every link is okay in this but from a quick look at it it some of
the links if not all were certainly updated. It will require another
pass in the browser but this is an emergency commit.
2025-11-29 14:54:19 -08:00
Cody Boone Ferguson 6c49bc8955 Various fixes and updates
The links to rules should all be good. This includes in news.html,
quick-start.html, next/submit.html, 2024/index.html (it had been
modified to refer to next/rules.html instead of 2024/rules.html) as well
as the guidelines and rules themselves (under next/).

Various typo fixes. I'm afraid there are likely others but I must let
others deal with that as I am out of time.

Removed FAQ about mastodon push notifications. When I added the FAQ
about push notifications for mastodon I was incorrect. The web browser
interface suggests it but I never got a push notification even before
Apple broke them. There seems to be no way at this time to get them. I
note that there was a screenshot in the FAQ but this file still is in
the repo possibly.

I regenerated the html files but it's possible I forgot to do one at the
last minute.
2025-11-29 12:03:55 -08:00
Cody Boone Ferguson 28349bfb95 Merge branch 'rules' of github.com:xexyl/winner into rules 2025-11-29 10:19:09 -08:00
Cody Boone Ferguson 4939cda9e1 Restore Makefile section in guidelines
Other fixes were made as well, including in the rules. More work has to
be done still.
2025-11-29 10:15:47 -08:00
Cody Boone Ferguson 4a58a9e507 Merge branch 'master' into rules 2025-11-29 09:46:24 -08:00
Cody Boone Ferguson d49e2f2d9c More work on rules, guidelines and FAQ
More links have to be checked as does formatting and other things. The
guidelines have had some typo fixes but more has to be done.
2025-11-29 09:28:49 -08:00
Anthony Howe 7c886e9f80 Part 1 Guidelines review. 2025-11-29 04:09:15 -05:00
Landon Curt Noll 698cd8f92b checkpoint rules & guidelines, FAQ update, draft IOCCC29 dates
This is a draft edit of the revised IOCCC guidelines for **IOCCC29**.

Due the above, `next/guidelines.md` has undergone a significant update.
The `next/rules.md` and `faq.md` files have been modified accordingly.

The `faq.md` version is now **29.01 2025-11-28**.
The `next/guidelines.md` version is now **29.00 2025-11-28**.
The `next/rules.md` version is now *29.08 2025-11-28**.

Draft **IOCCC29** dates have been added to `rules.md`.

Ran `make quick_www` to perform the above.

TODO: Continue to revise and improve the IOCCC guidelines.

TODO: Fix typos and minor nits in the `next/guidelines.md`.

TODO: Fix typos and minor nits in the `next/rules.md`.
2025-11-29 00:14:31 -08:00
Landon Curt Noll ee2f499839 checkpoint rules version 29.04 2025-11-20
Switched to "#" (hash) for headings in `rules.md`.

Added "-" (dash) after the rule number and before the
rule keyword.

Adjusted links rules elsewhere according to the above.

Ran `make quick_www` to perform the above.
2025-11-20 16:16:50 -08:00
Landon Curt Noll ea37a9f559 checkpoint rules version 29.00 2025-11-19.
This is a work in progress towards an improved rule set for **IOCCC29**.

Links to rules elsewhere on the site were modified as needed.
2025-11-19 22:43:00 -08:00
Cody Boone Ferguson 97c25ca4f7 Update FAQ, rules/guidelines etc. for #208
This commit also removed some of the 'new marks' in the guidelines and
rules (as they're no longer new) and some that were in the FAQ (which
only happened when they were changed over to the FAQ).

Removed problematic FAQs (per discussion). This required renumbering.

Updated references of chkentry to chksubmit (only a few references to
chkentry remain now - advising contestants to not use it but simply
stating it is for the judges and it is what chksubmit uses).

Added note in guidelines about gotos becoming 'old' (as Landon told me
it is something Leo wanted in the next guidelines thanks to me). Just so
Landon does not forget my C sins. :-)

I have regenerated the html files but the guidelines.html and rules.html
files have not been link-checked as these files will be modified by the
judges a fair amount so there is no point yet. I believe I got
references to nuked FAQs out but it's possible some were missed.

The quick-start.md and next/submit.md (and their html files) were
updated as well to refer to chksubmit instead of chkentry.

It is quite possible some things were missed but this should help move
things closer to getting ready for IOCCC29 in December.
2025-11-17 09:05:30 -08:00
Cody Boone Ferguson ea24f6b0d0 Minor fixes and updates go next/guidelines
Some information is no longer useful - they were put in during the
IOCCC28 to let people know the version changes during the contest which
noted some useful information.

Also added references to chksubmit.

Rebuilt next/guidelines.html with these changes.
2025-09-28 03:54:31 -07:00
Landon Curt Noll 09750f8899 release winning entries of IOCCC28 under the year 2024
Congratulations to:

* 2024/anders - Prize in sound coding - layered music generator
* 2024/burton - Prize in pentagrammatology - wordle hard mode solver
* 2024/cable1 - Prize in bot talk - LLM inference engine
* 2024/cable2 - Prize in murky waters - salmon recipe
* 2024/carlini - Prize in perfect timing - Intel 4004 emulation
* 2024/codemeow - Prize in tray planting - bonsai generator
* 2024/endoh1 - Prize in patient pointillism - slow ray tracer in CPP
* 2024/endoh2 - Prize in solid body physics - rotating rigid body simulation
* 2024/ferguson1 - Prize in diabolical logistics - Oregon trail pact with the devil
* 2024/ferguson2 - Prize in yil-tas - Navajo code talker translator
* 2024/howe - Nice accent eh-ward - mini vi
* 2024/kramer - Prize in linguistic arithmetic - natural language numerical calculator
* 2024/kurdyukov1 - Prize in phased periodicity - phase of the Moon
* 2024/kurdyukov2 - Prize in art restoration - JPEG artifact removal
* 2024/kurdyukov3 - Prize in virtual quietus - gaming VM and doom
* 2024/kurdyukov4 - Prize in embiggening - encode without literals
* 2024/maffiodo - Prize in creative interpretation - Jav\*script interpreter
* 2024/mills - Prize in ℤ₃ - Infocom v3 story interpreter
* 2024/stedolan - Best one liner - icon from MD5
* 2024/straadt - Prize in imitative rebooting - OpenRISC CPU and Linux
* 2024/tmarrec - Prize in cyclonic coding - 3D tornado simulation
* 2024/tompng - Prize in quasi bijection - vortex encryptor decryptor
* 2024/weaver - Sur prize - rickroll

Ran `make update` to perform the above.
 	new file:   2024/burton/.entry.json
2025-08-02 14:43:07 -07:00
Landon Curt Noll 3106998954 allow for year level archive of rules and guidelines
Adjusted `bin/md2html.cfg` to allow for the creation of year level
archive of the rules and guidelines that were in effect when the given
year's content opened for submissions.

We improved `bin/gen-year-index.sh` so that if there exists
a `YYYY/rules.md` rules archive, then `YYYY/rules.html`
will be created.

We improved `bin/gen-year-index.sh` so that if there exists
a `YYYY/guidelines.md` rules archive, then `YYYY/guidelines.html`
will be created.

Changed `bin/gen-year-index.sh` VERSION from "2.0.0 2025-03-13"
to "2.1.0 2025-07-05".

Adjusted `next/rules.md` and `next/guidelines.md` so that when they are
copied as archived copies of rules and guidelines under a YYYY directory,
the internal links do not break.  There are **NO** changes to the readable
contents of the rules and guidelines, only some changes to a few internal links.

Updated `1992/buzzard.2/index.html, `1993/rince/index.html`, and
`2012/omoikane/index.html that were modified by recent commits.

Rebuild sitemap due to the changes above.

Ran `make www` to test and perform the above.
2025-07-05 21:24:13 -07:00
Landon Curt Noll f98d840a0d fixed typos relate to judging state 2025-06-04 23:46:26 -07:00
Landon Curt Noll 9d928ec1c4 close the IOCCC for submissions 2025-06-04 21:03:15 -07:00
Landon Curt Noll a201804e01 fix open state, update sitemap 2025-04-17 16:47:22 -07:00
Landon Curt Noll f679e76142 processed more of John Dalbec's fix of 2000/dlowe
Added processing of "%%REPO_TOP_URL%%" tokens to `bin/subst.default.sh`.

Updated `find-missing-links.sh` to not falsely report missing links
when a "%%REPO_TOP_URL%%" token is used.

Changed `bin/subst.default.sh` VERSION from "1.3.2 2024-08-05"
to "1.4.0 2025-04-16".

Changed `bin/find-missing-links.sh` VERSION from "1.1.1 2024-04-28"
to "1.2.0 2025-04-16".

Due to a `pandoc(1)` bug fix, `2011/fredriksson/index.html` and
`2012/kang/index.html` were modified.  The bug fix removed extraneous
whitespace that was previously introduced into HTML under certain
situations.  These 2 changes do **NOT** impact the way web browsers
render these pages, however.

Updated sitemap.

Updated tarballs based on entry mods since 2025 March 4
(commit 233e5e90a5 just prior
to the IOCCC28 open).

Tested the above via `make update` on macOS.
2025-04-16 13:54:27 -07:00
Landon Curt Noll 096d2eb754 add news of 2025-03-15
Add news of the mkiocccentry toolkit version 2.4.4 2025-03-15.

Note that C is the official locale of the IOCCC in the IOCCC guidelines
version 28.47 2025-03-15.
2025-03-15 15:20:13 -07:00
Landon Curt Noll 91dc41c998 fix HTML error in guidelines
A "<p>..</p>" may not span a list.
2025-03-12 21:23:50 -07:00
Cody Boone Ferguson 864f17e4a5 Add details on versions
New FAQ on what the minimum versions are (this should be updated every
contest or updated to refer to the result of the issue I opened at the
other repo - post IOCCC28) for each tool.

Added details about the new (soon to be released) version of the tools
that now search under $PATH.

This commit updated the FAQ, the guidelines and the quick start guide.

As a reminder you do NOT need to use the upcoming release of the tools
and not doing so will not invalidate any of your submissions as it is
based on a minimum version, not an exact version.
2025-03-12 03:27:58 -07:00
Cody Boone Ferguson 8968cf8904 Update FAQ and guidelines about new options
The new options to mkiocccentry are -x to delete the submission
directory if if it already exists and the -u uuidfile and -U uuidstr
options.

NOTE: it is NOT required to update the tools for this IOCCC and you do
NOT have to read the updated guidelines to follow the guidelines for
this IOCCC.
2025-03-10 06:28:54 -07:00
Landon Curt Noll e180f6ae5e open IOCCC28 2025-03-05 14:26:26 -08:00
Cody Boone Ferguson b00f425d44 Fix link in guidelines.html found by make test 2025-03-04 12:16:44 -08:00
Cody Boone Ferguson 49609b0ead Final edits before IOCCC28 (I hope :-) )
Renamed some FAQs (typos and/or other things).

Fix a number of typos in various files (including markdown format
errors).

Rules and guidelines should be relatively good although as there is a
lot to get through and not much time left maybe I missed something (I
also kind of cheated doing the final checks with the guidelines rather
than going through them all again).

The next/try.sh and next/try.alt.sh scripts have had updates as well and
the next/Makefile.example was modified too.

The index.html page now has an anchor for goals of the contest so that
the goals in the rules could simply link to it in index.html.

Although some text had to be added (and some corrected) a reasonable
amount of text was also removed as it was elsewhere or was extraneous in
some way.
2025-03-04 12:11:08 -08:00
Landon Curt Noll 29408c8293 complete our review of the IOCCC rules and IOCCC guidelines
A review of the IOCCC rules and IOCCC guidelines, @xexyl,
on  2025 March 4 would be very much welcome.
2025-03-04 02:09:13 -08:00
Landon Curt Noll 37ba5f892b important IOCCC rules updates, checkpoint on guidelines 2025-03-03 22:07:05 -08:00
Landon Curt Noll 388431628e more rules and guidelines improvements and tweaks 2025-03-03 17:23:33 -08:00