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

Improve FAQ about providing deobfuscated code

Browse Source 
It is preferable that unobfuscated code is by the author if they have
(and many have done exactly that).

It would also be preferable to include the author or authors of the entry or
entries if at all possible.

This update includes a link to how to find more information about an
author and I think that FAQ was slightly improved as well.
This commit is contained in:
Cody Boone Ferguson committed 2024-07-17 09:52:09 -07:00
1 parent b3311322af
commit 442cbfc664
2 files changed
+128 -71
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

faq.html
+61 -32
View File
@@ -469,7 +469,7 @@ other inconsistencies with the original entry?</a></li>
<li><a class="normal" href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a></li>
<li><a class="normal" href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a></li>
<li><a class="normal" href="#faq5_7">5.7 - How may I support the IOCCC?</a></li>
<li><a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, how may I contribute the source?</a></li>
<li><a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, may I contribute the source?</a></li>
</ul>
<h2 id="section-6---miscellaneous-ioccc">Section 6 - <a href="#faq6">Miscellaneous IOCCC</a></h2>
<ul>
@@ -3324,50 +3324,72 @@ efforts, we suggest making an <strong>Anonymous</strong> gift via the
<a href="https://www.amazon.com/hz/wishlist/ls/3HSNTEL8RQ1M0?ref_=wl_share">IOCCC Amazon wishlist</a>.</p>
<div id="faq5_8">
<div id="deobfuscated">
<h3 id="faq-5.8-i-deobfuscated-some-entry-code-how-may-i-contribute-the-source">FAQ 5.8: I deobfuscated some entry code, how may I contribute the source?</h3>
<h3 id="faq-5.8-i-deobfuscated-some-entry-code-may-i-contribute-the-source">FAQ 5.8: I deobfuscated some entry code, may I contribute the source?</h3>
</div>
</div>
<p>The <a href="judges.html">IOCCC judges</a> welcome those who wish to contribute
a <strong>deobfuscated</strong> version of a winning IOCCC entry: from either
the <a href="authors.html">author(s)</a> or from people such as
yourself who are willing to contribute <strong>deobfuscated</strong> code.
We also welcome contributions to improve existing <strong>deobfuscated</strong> code.</p>
<p><strong>HISTORICAL NOTE</strong>: The IOCCC web site has shifted to a more
<p><strong>PLEASE NOTE</strong>: <strong>many <a href="authors.html">winning authors</a></strong> have unobfuscated code
of their <strong>own entries</strong> and you should look for this first, often on GitHub or on
their website; see the FAQ on <a href="#author-information">how to find more information about a winning
author of an entry</a> for how you might find this
information. We ask you to, if you can find them, please ask them what they
think as they can often provide invaluable information; this is less of an issue
for fixes of bugs - not features - found in the <a href="bugs.html">bugs.html</a> file.</p>
<p>The <a href="judges.html">IOCCC judges</a> welcome those who wish to contribute a
<strong>deobfuscated</strong> version of a winning IOCCC entry: from either the <a href="authors.html">author or
authors</a> (<strong>which is much, much preferred</strong>) or from people such
as yourself (assuming you are not the author :-) ) who are willing to contribute
<strong>deobfuscated</strong> code. We also welcome contributions to improve existing
<strong>deobfuscated</strong> code. You might wish to look at their URL or alt URL (see below
for more details) <strong>first</strong> as quite a few <a href="authors.html">authors</a> have provided
unobfuscated code of their entries and this is far more fair to the <a href="authors.html">winning
authors</a> (and it is much more likely to be identical functionality
as well, though many <a href="authors.html">authors</a> are experienced and skilled enough
to add features <strong>after or during obfuscation!</strong> and many in fact do).</p>
<p><strong>HISTORICAL NOTE</strong>: The IOCCC website has shifted to a more
educational theme: preferring to explain entries rather than hiding
things under the guise of such information being a “<em>spoiler</em>”. We
now use the term <strong>deobfuscated</strong> instead of “<em>spoiler</em>” for this reason.</p>
<p>We ask that the <strong>deobfuscated</strong> code be identical to the
functionality of the winning IOCCC entry code.</p>
<p><strong>NOTE</strong>: Be aware that IOCCC entry code may contain <strong>extremely
subtle and obscure side effects</strong> (i.e., features). Those wishing
to contribute a <strong>deobfuscated</strong> version of code should <strong>strive
to mimic</strong> the original (or existing <code>prog.c</code>code) IOCCC entry
code as much as possible.</p>
now use the term <strong>deobfuscated</strong> instead of “<em>spoiler</em>” for this reason, at
least in most cases; other terms might be used, including on a rare occasion
<em>spoiler</em>, this depending on context.</p>
<p>We ask that the <strong>deobfuscated</strong> code be <strong>identical in functionality</strong>
to the winning IOCCC entry code.</p>
<p><strong>NOTE</strong>: Be aware that IOCCC entry code may contain <strong>extremely subtle and
obscure side effects</strong> (i.e., features). Those wishing to contribute a
<strong>deobfuscated</strong> version of code should <strong>strive to mimic</strong> the original (or
existing) IOCCC entry code as much as possible. Some authors can be contacted
(see above for more details on this) and you could ask them for details and if
possible it would be good to include them in the discussion as well (see below)
as it is <strong>very likely</strong> there are things that will be missed when trying to
deobfuscate the code, some of which might be important to the author.</p>
<p>To contribute your <strong>deobfuscated</strong> code, please open up a
<a href="https://github.com/ioccc-src/temp-test-ioccc/discussions/new?category=show-and-tell">Show and tell new discussion</a>.
<a href="https://github.com/ioccc-src/temp-test-ioccc/discussions/new?category=show-and-tell">Show and tell new discussion</a>
with a title of the form:</p>
<pre><code> Enhancement: deobfuscated code for YYYY/dirname</code></pre>
<p>where “<em>YYYY/dirname</em>” refers to the winning IOCCC entry for which you are de-obfuscating.</p>
<blockquote>
<p>Enhancement: deobfuscated code for YYYY/dirname</p>
</blockquote>
<p>where “<code>YYYY/dirname</code>” refers to the winning IOCCC entry for which you are deobfuscating.</p>
<p>In the <strong>body</strong> of your new discussion, <strong>PLEASE</strong> provide us with a <strong>URL</strong> of
your <strong>deobfuscated</strong> code, along with whatever notes and/or comments you
think might be helpful.</p>
think might be helpful. If the author has a GitHub handle <strong>please</strong> mention
them in the discussion (see above part for how you might find out if they have a
GitHub account)!</p>
<p>If you are providing an improved version of some existing <strong>deobfuscated</strong> code, please
mention that in the <strong>body</strong> of your new discussion as well.</p>
<p>If there are <strong>limitations</strong> to how well the your <strong>deobfuscated</strong> code minics
the original (or existing <code>prog.c</code>code) IOCCC entry code, <strong>PLEASE</strong> mention those <strong>limitations</strong>
<p>If there are <strong>limitations</strong> to how well the your <strong>deobfuscated</strong> code mimics
the original (or existing) IOCCC entry code, <strong>PLEASE</strong> mention those <strong>limitations</strong>
in the <strong>body</strong> of your new discussion as well.</p>
<p>Any questions that may arise arise will be added as comments to the discussion.</p>
<p>Any questions that may arise will be added as comments to the discussion.</p>
<p><strong>SUGGESTION</strong>: <strong>PLEASE</strong> try to make your <strong>deobfuscated</strong> code readable. <strong>PLEASE</strong>
add comments as needed to help the reader of your <strong>deobfuscated</strong> code understand it.</p>
<p><strong>SUGGESTION</strong>: Where useful, consider providing, as <strong>C comments</strong>,
code fragments of from the original (or existing <code>prog.c</code>code) IOCCC
code fragments of from the original (or existing) IOCCC
entry code. While it is <strong>NOT</strong> necessary to include the entire
original code as <strong>C comments</strong>, including key parts from the
original (or existing <code>prog.c</code>code) IOCCC entry code may be helpful
original (or existing) IOCCC entry code may be helpful
to others who wish to read your <strong>deobfuscated</strong> code.</p>
<p>If your <strong>deobfuscated</strong> is accepted (in some form), the <a href="judges.html">IOCCC judges</a>
will be happy to <strong>thank you</strong> for your contribution in the
<a href="thanks-for-help.html">Thanking people for their help</a> file.</p>
<a href="thanks-for-help.html">thanking people for their help file</a>.</p>
<p>The <a href="judges.html">IOCCC judges</a> will do the rest of the work in integrate your
<strong>deobfuscated</strong> code as an “<em>alt</em>” code for the entry <strong>AND</strong> will reference
your <strong>deobfuscated</strong> code in the entry’s <code>index.html</code> file. We will be
@@ -4249,15 +4271,22 @@ the category <em>Website issue</em>).</p>
information on, you should see a section called <code>Author</code>. All you have to do is
click on the author’s name (it’s a link) and it will take you to their
information in the <a href="authors.html">authors.html</a> page.</p>
<p>There you will find various information, sometimes just location (if that’s
known) and other times their mastodon handle (as a link), a link to their
website (and sometimes an alt website), their GitHub handle (as a link) and a
link to their <code>author.json</code> file (the link title is their name). That
<code>author.json</code> file might have additional information. In all cases there is a
link to each of their winning entries.</p>
<p>There you will find various information including a link to their
<a href="authors.html">authors.html</a> information which includes various things like
their GitHub account (if known), a URL or alternate UL, mastodon handle,
location (if known and not anonymous location) and a link to their JSON author
file which has more information like email (if known).</p>
<p><strong>NOTE</strong>: you might wish to search google (or some other search engine) by their
name as sometimes you can find out their GitHub account even if it’s not in our
JSON files.</p>
<p>Of course if you know the author’s name you can go directly to
<a href="authors.html">authors.html</a> and click on their surname’s/last name’s/second
name’s initial and then scroll down (if necessary) to the author in question.</p>
<p><strong>NOTE</strong>: previously we included email in the <a href="authors.html">authors.html</a> page
but we have decided against this. Nevertheless, the <code>author_handle</code> link under
the author links to a JSON file which has the email address if it is known,
which you might wish to consult. You might also wish to look at their URL or
alternate URL for more information.</p>
<hr style="width:10%;text-align:left;margin-left:0">
<p>Jump to: <a href="#">top</a></p>
<!--