From 388431628eb4e821db74c25d0bdbc3826ac25365 Mon Sep 17 00:00:00 2001 From: Landon Curt Noll Date: Mon, 3 Mar 2025 17:23:33 -0800 Subject: [PATCH] more rules and guidelines improvements and tweaks --- next/guidelines.html | 45 ++++++++++++++++++------- next/guidelines.md | 48 +++++++++++++++++++------- next/rules.html | 67 +++++++++++++++---------------------- next/rules.md | 80 ++++++++++++++++++-------------------------- 4 files changed, 127 insertions(+), 113 deletions(-) diff --git a/next/guidelines.html b/next/guidelines.html index 9aac248db..066eb705c 100644 --- a/next/guidelines.html +++ b/next/guidelines.html @@ -613,7 +613,7 @@ where workdir an topdir are the same as above. You may NOT submit a tarball created by the -d or -s seed option!

-IMPORTANT NOTE: if you run the program outside the repo directory +IMPORTANT NOTE: if you run an IOCCC related tool outside the repo directory (specifying the absolute or relative path to the tool) and you have not installed the tools (and we STRONGLY recommend you do install them), then you will have to specify the options for the tools that are required like @@ -791,14 +791,33 @@ Although we are in an age where AI/LLM can create code, we don’t want to stop anyone from using any tools they like when they’re working on their submissions.

-The IOCCC has a rich history of remarkable winning entries created by authors -who skillfully employed various code-related techniques such as code generators, -code analysis tools, machine learning tools, natural language models, code -copilot tools, and integrated development environments. Although it is NOT -required to use these kinds of tools in order to compile or run a submission, -individuals are free to continue to create their submissions using them. Even -so, we DISLIKE submissions that require an IDE (integrated -development environment). +The IOCCC has a rich history of remarkable winning entries created +by authors who skillfully employed various techniques +such as code generators, code analysis tools, machine learning tools, +natural language models, code copilot tools, so-called AI services, +and/or large language models. Although it is NOT required use such +things to develop your submission, you are free to continue to create +their submissions using such tools. +

+

+If you do make use of code generator, code analysis tool, machine learning +tool, natural language model, code copilot tool, a so-called AI service, +and/or large language models we ENCOURAGE you to describe how you used +them in your `remarks.md`` file. +

+

+You may use git, or services such as GitHub +to develop and maintain your submission. However, we DISLIKE +submissions that require the their use in order to build/compile. +

+

+Submissions will be judged in an environment that has no IDE. +The make(1) tool, your Makefile, and other tools found in +Single UNIX Specification +environments and systems that conform to the Single UNIX +Specification. +And submission that fails to compile/build because it requires +an IDE will be rejected.

There have been instances where winning entry code was quite different from the @@ -829,10 +848,10 @@ We tend to look down on a p number printer that claims that 16 is a prime number. If you do have a bug or mis-feature, you are better off documenting it. Noting “this submission sometimes prints the 4th power -of a prime by mistake” would save the above submission. And sometimes, -a strange bug/(mis-)feature can even help the submission! Of course, a correctly -working submission is best. Clever people will note that 16 might be prime -under certain conditions. Wise people, when submitting something clever +of a prime by mistake” in your remarks.md file would save the above submission. +Sometimes a strange bug/(mis-)feature can even help the submission! Of course, a correctly +working submission might be better. Clever people will note that 16 might be prime +under certain conditions. ;-) Wise people, when submitting something clever will fully explain such cleverness in their submission’s remarks.md file.

People who are considering to just use some complex mathematical diff --git a/next/guidelines.md b/next/guidelines.md index 096e480e8..ed4480bb1 100644 --- a/next/guidelines.md +++ b/next/guidelines.md @@ -240,7 +240,7 @@ You may **NOT** submit a tarball created by the `-d` or `-s seed` option!

-**IMPORTANT NOTE**: if you run the program outside the repo directory +**IMPORTANT NOTE**: if you run an IOCCC related tool outside the repo directory (specifying the absolute or relative path to the tool) and you have not installed the tools (and we **STRONGLY** recommend you **do** install them), then you will have to specify the options for the tools that are required like @@ -454,14 +454,36 @@ anyone from using any tools they like when they're working on their submissions.

-The IOCCC has a rich history of remarkable winning entries created by authors -who skillfully employed various code-related techniques such as code generators, -code analysis tools, machine learning tools, natural language models, code -copilot tools, and integrated development environments. Although it is **NOT** -required to use these kinds of tools in order to compile or run a submission, -individuals are free to continue to create their submissions using them. Even -so, we **DISLIKE** submissions that **require** an **IDE** (integrated -development environment). +The IOCCC has a rich history of remarkable winning entries created +by authors who skillfully employed various techniques +such as code generators, code analysis tools, machine learning tools, +natural language models, code copilot tools, so-called AI services, +and/or large language models. Although it is **NOT** required use such +things to develop your submission, you are free to continue to create +their submissions using such tools. +

+ +

+If you do make use of code generator, code analysis tool, machine learning +tool, natural language model, code copilot tool, a so-called AI service, +and/or large language models we **ENCOURAGE you to describe how you used +them** in your `remarks.md`` file. +

+ +

+You may use git, or services such as [GitHub](https://www.github.com) +to develop and maintain your submission. However, we **DISLIKE** +submissions that **require** the their use in order to build/compile. +

+ +

+Submissions will be judged in an environment that has no **IDE**. +The `make(1)` tool, your `Makefile`, and other tools found in +[Single UNIX Specification](https://en.wikipedia.org/wiki/Single_UNIX_Specification) +environments and systems that conform to the [Single UNIX +Specification](https://en.wikipedia.org/wiki/Single_UNIX_Specification). +And submission that fails to compile/build because it requires +an **IDE** will be rejected.

@@ -498,10 +520,10 @@ We tend to look down on a [prime number](https://en.wikipedia.org/wiki/Prime_number) printer that claims that 16 is a prime number. If you do have a bug or mis-feature, you are better off documenting it. Noting "_this submission sometimes prints the 4th power -of a prime by mistake_" would save the above submission. And sometimes, -a strange bug/(mis-)feature can even help the submission! Of course, a correctly -working submission is best. Clever people will note that 16 might be prime -under certain conditions. Wise people, when submitting something clever +of a prime by mistake_" in your `remarks.md` file would save the above submission. +Sometimes a strange bug/(mis-)feature can even help the submission! Of course, a correctly +working submission might be better. Clever people will note that 16 might be prime +under certain conditions. ;-) Wise people, when submitting something clever will fully explain such cleverness in their submission's `remarks.md` file.

diff --git a/next/rules.html b/next/rules.html index 6e091392b..6915e1c22 100644 --- a/next/rules.html +++ b/next/rules.html @@ -461,7 +461,7 @@ writing by contacting the judges.

-These IOCCC rules are version 28.27 2025-03-01. +These IOCCC rules are version 28.28 2025-03-03.

The markdown form of these rules is @@ -711,44 +711,6 @@ from an IOCCC judge, you may upload your submission the submit server ONLY while the contest is open.

-

-The submit server, in accordance with Rule 17, -places a limit of 3999971 octets on the size of your upload. -

-

-You are STRONGLY advised to use the mkiocccentry(1) tool -as found in the mkiocccentry repo -to form the file to upload to the submit server. -

-

-See the -FAQ on “obtaining and compiling the mkiocccentry tools” -for more information about the mkiocccentry(1) tool. -

-

-While the contest is open, you may modify your previously -uploaded submission by rebuilding your submission with the mkiocccentry(1) tool -and then re-uploading it to the same slot number on the submit server. -

-

-Once the contest enters the judging state, you will -NOT be allowed to upload your submission files. -

-

-The submit server will become active when the contest is open. -Until the contest status becomes open, -the submit server may be offline and/or unresponsive. -

-

-See the -FAQ on “obtaining and compiling the mkiocccentry tools” -and the -FAQ on “how to enter the IOCCC” -as that FAQ has important details on -how to register -as well as -how to upload your submission to the IOCCC. -

Jump to: top

Rule 4

@@ -832,6 +794,12 @@ which case they are. Of course, neither are any of the previous winning entries, unless of course you’re the winner! :-)

+

You are allowed to use tools to develop and test your submission. +These tools may include, but are not limited to code generators, code +analysis tools, machine learning tools, natural language models, code +copilot tools, etc.

+

+

See also Rule 5, Rule 18 and Rule 21.

Jump to: top

@@ -843,6 +811,10 @@ Submissions may only be uploaded to the IOCCC while the contest is open.

+The submit server, in accordance with Rule 17, +places a limit of 3999971 octets on the size of your upload. +

+

Once the contest is in the judging state (or closed), you may NOT upload submissions.

@@ -853,6 +825,21 @@ that they have received it. If uploaded submission is malformed, the +You are STRONGLY advised to use the mkiocccentry(1) tool +as found in the mkiocccentry repo +to form the file to upload to the submit server. +

+

+The submit server will become active when the contest is open. +Until the contest status becomes open, +the submit server may be offline and/or unresponsive. +

+

+See the +FAQ on “obtaining and compiling the mkiocccentry tools” +for more information about the mkiocccentry(1) tool. +

+

See the “Important IOCCC dates” section above for when these contest states are scheduled.

@@ -874,7 +861,7 @@ the interim ponder this modified quote purportedly said by Bill Gates:

10 submissions ought to be enough for anybody. :-)

-

– Bill Gates

+

– Bill Gates s/640K/10/ (allegedly)

Jump to: top

diff --git a/next/rules.md b/next/rules.md index 38e635ff5..ce26c3f97 100644 --- a/next/rules.md +++ b/next/rules.md @@ -51,7 +51,7 @@ Jump to: [top](#)

-These [IOCCC rules](rules.html) are version **28.27 2025-03-01**. +These [IOCCC rules](rules.html) are version **28.28 2025-03-03**.

@@ -389,51 +389,6 @@ the [submit server](https://submit.ioccc.org) **ONLY** while the contest is **[open](../faq.html#open)**.

-

-The [submit server](https://submit.ioccc.org), in accordance with [Rule 17](rules.html#rule17), -places a limit of **3999971** octets on the size of your upload. -

- -

-You are **STRONGLY** advised to use the `mkiocccentry(1)` tool -as found in the [mkiocccentry repo](https://github.com/ioccc-src/mkiocccentry) -to form the file to upload to the [submit server](https://submit.ioccc.org). -

- -

-See the -FAQ on "[obtaining and compiling the mkiocccentry tools](../faq.html#mkiocccentry)" -for more information about the `mkiocccentry(1)` tool. -

- -

-While the contest is **[open](../faq.html#open)**, you may modify your previously -uploaded submission by rebuilding your submission with the `mkiocccentry(1)` tool -and then re-uploading it to the same slot number on the [submit server](https://submit.ioccc.org). -

- -

-Once the contest enters the **[judging](../faq.html#judging)** state, you will -**NOT** be allowed to upload your submission files. -

- -

-The [submit server](https://submit.ioccc.org) will become active when the contest is **[open](../faq.html#open)**. -Until the contest status becomes **[open](../faq.html#open)**, -the [submit server](https://submit.ioccc.org) may be offline and/or unresponsive. -

- -

-See the -FAQ on "[obtaining and compiling the mkiocccentry tools](../faq.html#mkiocccentry)" -and the -FAQ on "[how to enter the IOCCC](../quick-start.html#enter)" -as that FAQ has important details on -[how to register](register.html) -as well as -[how to upload your submission](submit.html) to the IOCCC. -

- Jump to: [top](#) @@ -547,6 +502,14 @@ which case they are. Of course, neither are any of the previous winning entries, unless of course you're the winner! :-)

+

+You are allowed to use tools to develop and test your submission. +These tools may include, but are not limited to code generators, code +analysis tools, machine learning tools, natural language models, code +copilot tools, etc. + +

+

See also [Rule 5](#rule5), [Rule 18](#rule18) and [Rule 21](#rule21).

@@ -564,6 +527,11 @@ Submissions may only be uploaded to the [IOCCC submit server](https://submit.ioc while the contest is **[open](../faq.html#open)**.

+

+The [submit server](https://submit.ioccc.org), in accordance with [Rule 17](rules.html#rule17), +places a limit of **3999971** octets on the size of your upload. +

+

Once the contest is in the **[judging](../faq.html#judging)** state (or **[closed](../faq.html#closed)**), you may **NOT** upload submissions. @@ -576,6 +544,24 @@ that they have received it. If uploaded submission is malformed, the [IOCCC jud **MAY** (but are not required to) modify the slot comment accordingly.

+

+You are **STRONGLY** advised to use the `mkiocccentry(1)` tool +as found in the [mkiocccentry repo](https://github.com/ioccc-src/mkiocccentry) +to form the file to upload to the [submit server](https://submit.ioccc.org). +

+ +

+The [submit server](https://submit.ioccc.org) will become active when the contest is **[open](../faq.html#open)**. +Until the contest status becomes **[open](../faq.html#open)**, +the [submit server](https://submit.ioccc.org) may be offline and/or unresponsive. +

+ +

+See the +FAQ on "[obtaining and compiling the mkiocccentry tools](../faq.html#mkiocccentry)" +for more information about the `mkiocccentry(1)` tool. +

+

See the "[Important IOCCC dates](#dates)" section above for when these contest states are scheduled.

@@ -607,7 +593,7 @@ the interim ponder this modified quote purportedly said by Bill Gates:

> 10 submissions ought to be enough for anybody. :-) > -> -- Bill Gates +> -- Bill Gates s/640K/10/ (allegedly)

Jump to: [top](#)