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

Major FAQ updates

Browse Source 
A number of question answers have been merged and shortened somewhat.

Fix link in the menu of all html pages and the inc/ files that was
broken due to renaming an anchor.

The guidelines and rules have had a link fix (to the FAQ) as well as
some additional points added about the mkiocccentry toolkit.

More work in the FAQ needs to be done, including with the how to enter
the IOCCC, but as so much work has been done already I have decided to
make the commit to get these many important changes out of the way.
This commit is contained in:
Cody Boone Ferguson committed 2024-10-21 10:03:24 -07:00
1 parent b32930aabb
commit 265733ac88
414 files changed
+1387 -1360
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

next/guidelines.html
+8 -4
View File
@@ -137,7 +137,7 @@
</div>
<div class="outfit-font">
<a href="../faq.html#fix_web_site" class="sub-item-link">
<a href="../faq.html#fix_website" class="sub-item-link">
Fixing the website
</a>
</div>
@@ -288,7 +288,7 @@
Fixing IOCCC entries
</a>
<a class="mobile-submenu-item" href="../faq.html#fix_web_site">
<a class="mobile-submenu-item" href="../faq.html#fix_website">
Fixing the website
</a>
@@ -401,7 +401,7 @@ as well as our
FAQ on “<a href="../faq.html#question">asking questions</a>”
about these guidelines. You might also find the
FAQ in general useful, especially the
<a href="../faq.html#enter">FAQ section “How to enter: the bare minimum you need to know”</a>.</p>
<a href="../faq.html#submit">FAQ section “How to enter: the bare minimum you need to know”</a>.</p>
<h1 id="the-ioccc-is-closed">The IOCCC is closed</h1>
<p>The IOCCC is <strong>NOT</strong> accepting new submissions at this time. See the
<a href="../years.html">IOCCC winning entries page</a> for the entries that have won the
@@ -426,7 +426,7 @@ writing by <a href="../contact.html">contacting the judges</a>.</p>
<h2 id="ioccc-guidelines-version">IOCCC Guidelines version</h2>
</div>
<p class="leftbar">
These <a href="guidelines.html">IOCCC guidelines</a> are version <strong>28.17 2024-10-20</strong>.
These <a href="guidelines.html">IOCCC guidelines</a> are version <strong>28.18 2024-10-21</strong>.
</p>
<p><strong>IMPORTANT</strong>: Be <strong>SURE</strong> to read the <a href="rules.html">IOCCC rules</a>.</p>
<div id="change_marks">
@@ -663,6 +663,10 @@ See the <a href="https://github.com/ioccc-src/mkiocccentry">mkiocccentry repo</a
for the <code>mkiocccentry(1)</code> tool and below for more details.
</p>
<p class="leftbar">
<p><strong>IMPORTANT NOTE</strong>: make <strong>CERTAIN</strong> you have the most recent version of the
<code>mkiocccentry</code> toolkit! See the
FAQ on “<a href="../faq.html#mkiocccentry">obtaining the mkiocccentry toolkit</a>”.</p>
<p class="leftbar">
<code>mkiocccentry</code> runs a number of checks, by the tool itself and by executing other
tools, <em>before</em> packaging your xz compressed tarball. Once the tarball is
packaged it will run <code>txzchk(1)</code>, which runs <code>fnamchk(1)</code> as part of its
next/guidelines.md
+7 -2
View File
@@ -14,7 +14,7 @@ as well as our
FAQ on "[asking questions](../faq.html#question)"
about these guidelines. You might also find the
FAQ in general useful, especially the
[FAQ section "How to enter: the bare minimum you need to know"](../faq.html#enter).
[FAQ section "How to enter: the bare minimum you need to know"](../faq.html#submit).
# The IOCCC is closed
@@ -50,7 +50,7 @@ writing by [contacting the judges](../contact.html).
</div>
<p class="leftbar">
These [IOCCC guidelines](guidelines.html) are version **28.17 2024-10-20**.
These [IOCCC guidelines](guidelines.html) are version **28.18 2024-10-21**.
</p>
**IMPORTANT**: Be **SURE** to read the [IOCCC rules](rules.html).
@@ -343,6 +343,11 @@ See the [mkiocccentry repo](https://github.com/ioccc-src/mkiocccentry)
for the `mkiocccentry(1)` tool and below for more details.
</p>
<p class="leftbar">
**IMPORTANT NOTE**: make **CERTAIN** you have the most recent version of the
`mkiocccentry` toolkit! See the
FAQ on "[obtaining the mkiocccentry toolkit](../faq.html#mkiocccentry)".
<p class="leftbar">
`mkiocccentry` runs a number of checks, by the tool itself and by executing other
tools, _before_ packaging your xz compressed tarball. Once the tarball is
next/index.html
+2 -2
View File
@@ -137,7 +137,7 @@
</div>
<div class="outfit-font">
<a href="../faq.html#fix_web_site" class="sub-item-link">
<a href="../faq.html#fix_website" class="sub-item-link">
Fixing the website
</a>
</div>
@@ -288,7 +288,7 @@
Fixing IOCCC entries
</a>
<a class="mobile-submenu-item" href="../faq.html#fix_web_site">
<a class="mobile-submenu-item" href="../faq.html#fix_website">
Fixing the website
</a>
next/rules.html
+19 -9
View File
@@ -137,7 +137,7 @@
</div>
<div class="outfit-font">
<a href="../faq.html#fix_web_site" class="sub-item-link">
<a href="../faq.html#fix_website" class="sub-item-link">
Fixing the website
</a>
</div>
@@ -288,7 +288,7 @@
Fixing IOCCC entries
</a>
<a class="mobile-submenu-item" href="../faq.html#fix_web_site">
<a class="mobile-submenu-item" href="../faq.html#fix_website">
Fixing the website
</a>
@@ -396,12 +396,12 @@ They are are provided as a <strong>VERY TENTATIVE</strong> hint at <strong>what
MIGHT</strong> be used in the next IOCCC. In some cases they might
even be a copy of the rules from the previous IOCCC.</p>
<p>See our
FAQ on “<a href="#feedback">rules, guidelines, tools feedback</a>”
FAQ on “<a href="../faq.html#feedback">rules, guidelines, tools feedback</a>”
as well as our
FAQ on “<a href="../faq.html#question">about asking questions</a>”
about these rules. You might also find the
FAQ in general useful, especially the
<a href="../faq.html#enter">FAQ section “How to enter: the bare minimum you need to know”</a>.</p>
<a href="../faq.html#submit">FAQ section “How to enter: the bare minimum you need to know”</a>.</p>
<h1 id="the-ioccc-is-closed">The IOCCC is closed</h1>
<p>The IOCCC is <strong>NOT</strong> accepting new submissions at this time. See the
<a href="../years.html">IOCCC winning entries page</a> for the entries that have won the
@@ -426,7 +426,7 @@ writing by <a href="../contact.html">contacting the judges</a>.</p>
<h2 id="ioccc-rules-version">IOCCC Rules version</h2>
</div>
<p class="leftbar">
These <a href="rules.html">IOCCC rules</a> are version <strong>28.8 2024-10-17</strong>.
These <a href="rules.html">IOCCC rules</a> are version <strong>28.9 2024-10-21</strong>.
</p>
<p><strong>IMPORTANT</strong>: Be sure to read the <a href="guidelines.html">IOCCC guidelines</a>.</p>
<div id="change_marks">
@@ -488,9 +488,14 @@ The submit URL should be active on or slightly before <strong>2024-MMM-DD HH:MM:
available on the <a href="../index.html">official IOCCC website</a> on or slightly before
the start of this IOCCC. The <code>mkiocccentry</code> toolkit may be obtained at any time
at the <a href="https://github.com/ioccc-src/mkiocccentry">report mkiocccentry bugs</a>.</p>
<p><strong>Please recheck on or after the start of this IOCCC to be sure you
<p><strong>IMPORTANT</strong>: Please recheck on or after the start of this IOCCC to be sure you
are using the correct versions of these items <em>before using the IOCCC
submission URL</em></strong>.</p>
submission URL</em>.</p>
<p>See the
FAQ on “<a href="../faq.html#mkiocccentry">obtaining and compiling the mkiocccentry
tools</a>”
and the
FAQ on “<a href="../faq.html#submit">submitting to the IOCCC</a>”.</p>
<div id="rules">
<h1 id="ioccc-rules">IOCCC RULES</h1>
</div>
@@ -671,8 +676,8 @@ it is needed in your submissions <code>remarks.md</code> file.</p>
<h2 id="rule-12">Rule 12</h2>
</div>
<p><strong>Legal</strong> abuse of the rules is somewhat encouraged. <strong>A submission that, in
the opinion of the <a href="../judges.html">judges</a>, </strong>violates the rules will be disqualified<strong>.
Submissions that attempt to abuse the rules </strong>MUST** try to justify why
the opinion of the <a href="../judges.html">judges</a>, violates the rules will be disqualified</strong>.
Submissions that attempt to abuse the rules <strong>MUST</strong> try to justify why
their rule abuse is legal, in the <code>remarks.md</code> file.</p>
<div id="rule13">
<h2 id="rule-13">Rule 13</h2>
@@ -763,6 +768,11 @@ library will be used when compiling various tools.
Of course you <strong>can</strong> invoke <code>jparse(1)</code> if you wish to validate your own JSON
data file or some other JSON file.
</p>
<p><strong>IMPORTANT</strong>: Make <strong>SURE</strong> you have the most recent version of the
<code>mkiocccentry</code> toolkit! Not doing so will put you at a great risk of violating
this rule! See the
FAQ on “<a href="../faq.html#mkiocccentry">obtaining the mkiocccentry toolkit</a>”
for more details.</p>
<h3 id="rule-17---the-complex-details">Rule 17 - The COMPLEX details</h3>
<p class="leftbar">
Each submission <strong>MUST</strong> be in the form of a xz compressed tarball.
next/rules.md
+18 -6
View File
@@ -9,12 +9,12 @@ MIGHT** be used in the next IOCCC. In some cases they might
even be a copy of the rules from the previous IOCCC.
See our
FAQ on "[rules, guidelines, tools feedback](#feedback)"
FAQ on "[rules, guidelines, tools feedback](../faq.html#feedback)"
as well as our
FAQ on "[about asking questions](../faq.html#question)"
about these rules. You might also find the
FAQ in general useful, especially the
[FAQ section "How to enter: the bare minimum you need to know"](../faq.html#enter).
[FAQ section "How to enter: the bare minimum you need to know"](../faq.html#submit).
@@ -52,7 +52,7 @@ writing by [contacting the judges](../contact.html).
</div>
<p class="leftbar">
These [IOCCC rules](rules.html) are version **28.8 2024-10-17**.
These [IOCCC rules](rules.html) are version **28.9 2024-10-21**.
</p>
**IMPORTANT**: Be sure to read the [IOCCC guidelines](guidelines.html).
@@ -134,9 +134,15 @@ available on the [official IOCCC website](../index.html) on or slightly before
the start of this IOCCC. The `mkiocccentry` toolkit may be obtained at any time
at the [report mkiocccentry bugs](https://github.com/ioccc-src/mkiocccentry).
**Please recheck on or after the start of this IOCCC to be sure you
**IMPORTANT**: Please recheck on or after the start of this IOCCC to be sure you
are using the correct versions of these items _before using the IOCCC
submission URL_**.
submission URL_.
See the
FAQ on "[obtaining and compiling the mkiocccentry
tools](../faq.html#mkiocccentry)"
and the
FAQ on "[submitting to the IOCCC](../faq.html#submit)".
<div id="rules">
@@ -394,7 +400,7 @@ it is needed in your submissions `remarks.md` file.
</div>
**Legal** abuse of the rules is somewhat encouraged. **A submission that, in
the opinion of the [judges](../judges.html), **violates the rules will be disqualified**.
the opinion of the [judges](../judges.html), violates the rules will be disqualified**.
Submissions that attempt to abuse the rules **MUST** try to justify why
their rule abuse is legal, in the `remarks.md` file.
@@ -498,6 +504,12 @@ Of course you **can** invoke `jparse(1)` if you wish to validate your own JSON
data file or some other JSON file.
</p>
**IMPORTANT**: Make **SURE** you have the most recent version of the
`mkiocccentry` toolkit! Not doing so will put you at a great risk of violating
this rule! See the
FAQ on "[obtaining the mkiocccentry toolkit](../faq.html#mkiocccentry)"
for more details.
### Rule 17 - The COMPLEX details