diff --git a/Makefile b/Makefile index 2f0229175..bf4350c10 100644 --- a/Makefile +++ b/Makefile @@ -516,9 +516,9 @@ guidelines: ${GEN_TOP_HTML} next/guidelines.md faq: ${GEN_TOP_HTML} faq.md @echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-=' - @echo "Wait, you have questions? Uh oh!" + @echo "You have a question?" @${GEN_TOP_HTML} faq - @echo "Well, okay then!" + @echo "Perhaps the FAQ might help." @echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-=' diff --git a/faq.html b/faq.html index 1cfe81bad..02ca5f782 100644 --- a/faq.html +++ b/faq.html @@ -391,7 +391,8 @@
As a very last resort and/or if you feel the need to engage in a private -discussion with the IOCCC judges, then see -How to contact the IOCCC.
We realise that the IOCCC rules, IOCCC guidelines +and the IOCCC mkiocccentry tools +can be confusing or even seem overwhelming to some people.
+The IOCCC judges to welcomes questions about the IOCCC +and will be happy to help.
+Chances are, if you have a question, there are a number of other people who +have similar questions. So we recommend first view the +GitHub discussions for this repo +so see if someone else asked already. Feel free to join in on such a discussion, +even if to just say:
+++I have this question too.
+
Feel free to provide additional feedback in the existing discussion as needed.
+BTW: If your question just about the +IOCCC mkiocccentry tools, please +view the mkiocccentry repo discussions +instead.
+If you do not find an suitable open discussion, please consider opening a +new IOCCC repo discussion with +your question. Doing this may be of help to others with a question similar to yours.
+BTW: If your question just about the +IOCCC mkiocccentry tools, please +and suitable open discussion over there, then please consider opening a +new mkiocccentry discussion +over there.
+If you do not feel, for some reason, comfortable asking your question in public +(although we hope you consider asking it in public for the benefit of others), +then use the How to contact the IOCCC information to ask +a private question.
+IMPORTANT: When you ask your question (in public or as a private question) +PLEASE try to NOT spoil the surprise of your pending submission. +Try to ask for question in a more generic way as this will help others +with a similar question and this will not give away what you might be doing +with your submission. If the IOCCC judges truly need more +information, they will ask (either in public or suggest a private conversation).
+Again, please don’t hesitate to ask: Your question may be something that +others are wondering about as well.
+See also [FAQ about making suggestions)(#faq0_5).
+The IOCCC makes extensive use of markdown. diff --git a/faq.md b/faq.md index a2eb8d197..e9622f419 100644 --- a/faq.md +++ b/faq.md @@ -8,7 +8,8 @@ - [0.3 - May I use a different source or compiled filename than prog.c or prog?](#faq0_3) - [0.4 - What platform should I assume for my entry?](#faq0_4) - [0.5 - How may I comment or make a suggestion on IOCCC rules, guidelines and tools?](#faq0_5) -- [0.6 - What are the IOCCC best practices for using markdown?](#faq0_6) +- [0.6 - What is the best way to ask a question about the IOCCC rules, guideline and tools?](#faq0_6) +- [0.7 - What are the IOCCC best practices for using markdown?](#faq0_7) ## Section 1 - [History of the IOCCC](#faq1) @@ -457,14 +458,66 @@ have to say, consider adding comments to that particular discussion. Otherwise consider opening a [new mkiocccentry discussion](https://github.com/ioccc-src/mkiocccentry/discussions/new/choose). -As a very last resort and/or if you feel the need to engage in a private -discussion with the [IOCCC judges](judges.html), then see -[How to contact the IOCCC](contact.html). -