diff --git a/faq.html b/faq.html index add99f20b..d6b023bea 100644 --- a/faq.html +++ b/faq.html @@ -469,7 +469,7 @@ other inconsistencies with the original entry?
The IOCCC judges welcome those who wish to contribute -a deobfuscated version of a winning IOCCC entry: from either -the author(s) or from people such as -yourself who are willing to contribute deobfuscated code. -We also welcome contributions to improve existing deobfuscated code.
-HISTORICAL NOTE: The IOCCC web site has shifted to a more +
PLEASE NOTE: many winning authors have unobfuscated code +of their own entries and you should look for this first, often on GitHub or on +their website; see the FAQ on how to find more information about a winning +author of an entry 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 bugs.html file.
+The IOCCC judges welcome those who wish to contribute a +deobfuscated version of a winning IOCCC entry: from either the author or +authors (which is much, much preferred) or from people such +as yourself (assuming you are not the author :-) ) who are willing to contribute +deobfuscated code. We also welcome contributions to improve existing +deobfuscated code. You might wish to look at their URL or alt URL (see below +for more details) first as quite a few authors have provided +unobfuscated code of their entries and this is far more fair to the winning +authors (and it is much more likely to be identical functionality +as well, though many authors are experienced and skilled enough +to add features after or during obfuscation! and many in fact do).
+HISTORICAL NOTE: 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 “spoiler”. We -now use the term deobfuscated instead of “spoiler” for this reason.
-We ask that the deobfuscated code be identical to the -functionality of the winning IOCCC entry code.
-NOTE: Be aware that IOCCC entry code may contain extremely
-subtle and obscure side effects (i.e., features). Those wishing
-to contribute a deobfuscated version of code should strive
-to mimic the original (or existing prog.ccode) IOCCC entry
-code as much as possible.
We ask that the deobfuscated code be identical in functionality +to the winning IOCCC entry code.
+NOTE: Be aware that IOCCC entry code may contain extremely subtle and +obscure side effects (i.e., features). Those wishing to contribute a +deobfuscated version of code should strive to mimic 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 very likely there are things that will be missed when trying to +deobfuscate the code, some of which might be important to the author.
To contribute your deobfuscated code, please open up a -Show and tell new discussion. +Show and tell new discussion with a title of the form:
- Enhancement: deobfuscated code for YYYY/dirname
-where “YYYY/dirname” refers to the winning IOCCC entry for which you are de-obfuscating.
+++Enhancement: deobfuscated code for YYYY/dirname
+
where “YYYY/dirname” refers to the winning IOCCC entry for which you are deobfuscating.
In the body of your new discussion, PLEASE provide us with a URL of your deobfuscated code, along with whatever notes and/or comments you -think might be helpful.
+think might be helpful. If the author has a GitHub handle please mention +them in the discussion (see above part for how you might find out if they have a +GitHub account)!If you are providing an improved version of some existing deobfuscated code, please mention that in the body of your new discussion as well.
-If there are limitations to how well the your deobfuscated code minics
-the original (or existing prog.ccode) IOCCC entry code, PLEASE mention those limitations
+
If there are limitations to how well the your deobfuscated code mimics +the original (or existing) IOCCC entry code, PLEASE mention those limitations in the body of your new discussion as well.
-Any questions that may arise arise will be added as comments to the discussion.
+Any questions that may arise will be added as comments to the discussion.
SUGGESTION: PLEASE try to make your deobfuscated code readable. PLEASE add comments as needed to help the reader of your deobfuscated code understand it.
SUGGESTION: Where useful, consider providing, as C comments,
-code fragments of from the original (or existing prog.ccode) IOCCC
+code fragments of from the original (or existing) IOCCC
entry code. While it is NOT necessary to include the entire
original code as C comments, including key parts from the
-original (or existing prog.ccode) IOCCC entry code may be helpful
+original (or existing) IOCCC entry code may be helpful
to others who wish to read your deobfuscated code.
If your deobfuscated is accepted (in some form), the IOCCC judges will be happy to thank you for your contribution in the -Thanking people for their help file.
+thanking people for their help file.The IOCCC judges will do the rest of the work in integrate your
deobfuscated code as an “alt” code for the entry AND will reference
your deobfuscated code in the entry’s index.html file. We will be
@@ -4249,15 +4271,22 @@ the category Website issue).
Author. 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 authors.html page.
-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 author.json file (the link title is their name). That
-author.json file might have additional information. In all cases there is a
-link to each of their winning entries.
There you will find various information including a link to their +authors.html 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).
+NOTE: 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.
Of course if you know the author’s name you can go directly to authors.html and click on their surname’s/last name’s/second name’s initial and then scroll down (if necessary) to the author in question.
+NOTE: previously we included email in the authors.html page
+but we have decided against this. Nevertheless, the author_handle 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.
Jump to: top