mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

more rules and guidelines improvements and tweaks

Browse Source
This commit is contained in:
Landon Curt Noll committed 2025-03-03 17:23:33 -08:00
1 parent 0ac0a7f240
commit 388431628e
4 files changed
+127 -113
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

next/guidelines.html
+32 -13
View File
@@ -613,7 +613,7 @@ where <code>workdir</code> an <code>topdir</code> are the same as above.
You may <strong>NOT</strong> submit a tarball created by the <code>-d</code> or <code>-s seed</code> option!
</p>
<p class="leftbar">
<strong>IMPORTANT NOTE</strong>: if you run the program outside the repo directory
<strong>IMPORTANT NOTE</strong>: 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 <strong>STRONGLY</strong> recommend you <strong>do</strong> 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.
</p>
<p class="leftbar">
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 <strong>NOT</strong>
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 <strong>DISLIKE</strong> submissions that <strong>require</strong> an <strong>IDE</strong> (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 <strong>NOT</strong> required use such
things to develop your submission, you are free to continue to create
their submissions using such tools.
</p>
<p class="leftbar">
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 <strong>ENCOURAGE you to describe how you used
them</strong> in your `remarks.md`` file.
</p>
<p class="leftbar">
You may use git, or services such as <a href="https://www.github.com">GitHub</a>
to develop and maintain your submission. However, we <strong>DISLIKE</strong>
submissions that <strong>require</strong> the their use in order to build/compile.
</p>
<p class="leftbar">
Submissions will be judged in an environment that has no <strong>IDE</strong>.
The <code>make(1)</code> tool, your <code>Makefile</code>, and other tools found in
<a href="https://en.wikipedia.org/wiki/Single_UNIX_Specification">Single UNIX Specification</a>
environments and systems that conform to the <a href="https://en.wikipedia.org/wiki/Single_UNIX_Specification">Single UNIX
Specification</a>.
And submission that fails to compile/build because it requires
an <strong>IDE</strong> will be rejected.
</p>
<p class="leftbar">
There have been instances where winning entry code was quite different from the
@@ -829,10 +848,10 @@ We tend to look down on a <a href="https://en.wikipedia.org/wiki/Prime_number">p
number</a> 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 “<em>this submission sometimes prints the 4th power
of a prime by mistake</em>” 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</em>” in your <code>remarks.md</code> 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 <code>remarks.md</code> file.
</p>
<p>People who are considering to just use some complex mathematical
next/guidelines.md
+35 -13
View File
@@ -240,7 +240,7 @@ You may **NOT** submit a tarball created by the `-d` or `-s seed` option!
</p>
<p class="leftbar">
**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.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
@@ -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.
</p>
next/rules.html
+27 -40
View File
@@ -461,7 +461,7 @@ writing by <a href="../contact.html">contacting the judges</a>.</p>
</div>
</div>
<p class="leftbar">
These <a href="rules.html">IOCCC rules</a> are version <strong>28.27 2025-03-01</strong>.
These <a href="rules.html">IOCCC rules</a> are version <strong>28.28 2025-03-03</strong>.
</p>
<p class="leftbar">
The markdown form of these rules <a href="rules.md" download="rules.md">is
@@ -711,44 +711,6 @@ from an <a href="../judges.html">IOCCC judge</a>, you may upload your submission
the <a href="https://submit.ioccc.org">submit server</a> <strong>ONLY</strong> while the
contest is <strong><a href="../faq.html#open">open</a></strong>.
</p>
<p class="leftbar">
The <a href="https://submit.ioccc.org">submit server</a>, in accordance with <a href="rules.html#rule17">Rule 17</a>,
places a limit of <strong>3999971</strong> octets on the size of your upload.
</p>
<p class="leftbar">
You are <strong>STRONGLY</strong> advised to use the <code>mkiocccentry(1)</code> tool
as found in the <a href="https://github.com/ioccc-src/mkiocccentry">mkiocccentry repo</a>
to form the file to upload to the <a href="https://submit.ioccc.org">submit server</a>.
</p>
<p class="leftbar">
See the
FAQ on “<a href="../faq.html#mkiocccentry">obtaining and compiling the mkiocccentry tools</a>”
for more information about the <code>mkiocccentry(1)</code> tool.
</p>
<p class="leftbar">
While the contest is <strong><a href="../faq.html#open">open</a></strong>, you may modify your previously
uploaded submission by rebuilding your submission with the <code>mkiocccentry(1)</code> tool
and then re-uploading it to the same slot number on the <a href="https://submit.ioccc.org">submit server</a>.
</p>
<p class="leftbar">
Once the contest enters the <strong><a href="../faq.html#judging">judging</a></strong> state, you will
<strong>NOT</strong> be allowed to upload your submission files.
</p>
<p class="leftbar">
The <a href="https://submit.ioccc.org">submit server</a> will become active when the contest is <strong><a href="../faq.html#open">open</a></strong>.
Until the contest status becomes <strong><a href="../faq.html#open">open</a></strong>,
the <a href="https://submit.ioccc.org">submit server</a> may be offline and/or unresponsive.
</p>
<p class="leftbar">
See the
FAQ on “<a href="../faq.html#mkiocccentry">obtaining and compiling the mkiocccentry tools</a>”
and the
FAQ on “<a href="../quick-start.html#enter">how to enter the IOCCC</a>”
as that FAQ has important details on
<a href="register.html">how to register</a>
as well as
<a href="submit.html">how to upload your submission</a> to the IOCCC.
</p>
<p>Jump to: <a href="#">top</a></p>
<div id="rule4">
<h2 id="rule-4">Rule 4</h2>
@@ -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! :-)
</p>
<p class="leftbar">
<p>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.</p>
</p>
<p class="leftbar">
See also <a href="#rule5">Rule 5</a>, <a href="#rule18">Rule 18</a> and <a href="#rule21">Rule 21</a>.
</p>
<p>Jump to: <a href="#">top</a></p>
@@ -843,6 +811,10 @@ Submissions may only be uploaded to the <a href="https://submit.ioccc.org">IOCCC
while the contest is <strong><a href="../faq.html#open">open</a></strong>.
</p>
<p class="leftbar">
The <a href="https://submit.ioccc.org">submit server</a>, in accordance with <a href="rules.html#rule17">Rule 17</a>,
places a limit of <strong>3999971</strong> octets on the size of your upload.
</p>
<p class="leftbar">
Once the contest is in the <strong><a href="../faq.html#judging">judging</a></strong> state (or
<strong><a href="../faq.html#closed">closed</a></strong>), you may <strong>NOT</strong> upload submissions.
</p>
@@ -853,6 +825,21 @@ that they have received it. If uploaded submission is malformed, the <a href="..
<strong>MAY</strong> (but are not required to) modify the slot comment accordingly.
</p>
<p class="leftbar">
You are <strong>STRONGLY</strong> advised to use the <code>mkiocccentry(1)</code> tool
as found in the <a href="https://github.com/ioccc-src/mkiocccentry">mkiocccentry repo</a>
to form the file to upload to the <a href="https://submit.ioccc.org">submit server</a>.
</p>
<p class="leftbar">
The <a href="https://submit.ioccc.org">submit server</a> will become active when the contest is <strong><a href="../faq.html#open">open</a></strong>.
Until the contest status becomes <strong><a href="../faq.html#open">open</a></strong>,
the <a href="https://submit.ioccc.org">submit server</a> may be offline and/or unresponsive.
</p>
<p class="leftbar">
See the
FAQ on “<a href="../faq.html#mkiocccentry">obtaining and compiling the mkiocccentry tools</a>”
for more information about the <code>mkiocccentry(1)</code> tool.
</p>
<p class="leftbar">
See the “<a href="#dates">Important IOCCC dates</a>” section above for when these contest states are scheduled.
</p>
<p class="leftbar">
@@ -874,7 +861,7 @@ the interim ponder this modified quote purportedly said by Bill Gates:
<p class="leftbar">
<blockquote>
<p>10 submissions ought to be enough for anybody. :-)</p>
<p>– Bill Gates</p>
<p>– Bill Gates s/640K/10/ (allegedly)</p>
</blockquote>
</p>
<p>Jump to: <a href="#">top</a></p>
next/rules.md
+33 -47
View File
@@ -51,7 +51,7 @@ Jump to: [top](#)
</div>
<p class="leftbar">
These [IOCCC rules](rules.html) are version **28.27 2025-03-01**.
These [IOCCC rules](rules.html) are version **28.28 2025-03-03**.
</p>
<p class="leftbar">
@@ -389,51 +389,6 @@ the [submit server](https://submit.ioccc.org) **ONLY** while the
contest is **[open](../faq.html#open)**.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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).
</p>
<p class="leftbar">
See the
FAQ on "[obtaining and compiling the mkiocccentry tools](../faq.html#mkiocccentry)"
for more information about the `mkiocccentry(1)` tool.
</p>
<p class="leftbar">
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).
</p>
<p class="leftbar">
Once the contest enters the **[judging](../faq.html#judging)** state, you will
**NOT** be allowed to upload your submission files.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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.
</p>
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! :-)
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
See also [Rule 5](#rule5), [Rule 18](#rule18) and [Rule 21](#rule21).
</p>
@@ -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)**.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
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).
</p>
<p class="leftbar">
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.
</p>
<p class="leftbar">
See the
FAQ on "[obtaining and compiling the mkiocccentry tools](../faq.html#mkiocccentry)"
for more information about the `mkiocccentry(1)` tool.
</p>
<p class="leftbar">
See the "[Important IOCCC dates](#dates)" section above for when these contest states are scheduled.
</p>
@@ -607,7 +593,7 @@ the interim ponder this modified quote purportedly said by Bill Gates:
<p class="leftbar">
> 10 submissions ought to be enough for anybody. :-)
>
> -- Bill Gates
> -- Bill Gates s/640K/10/ (allegedly)
</p>
Jump to: [top](#)