Reorganise menus

The sections have been modified a fair amount. The Entries menu has been
extended to have: Fixing entries, Updating author info, Thanks for the
help. The first two were moved from FAQ and the last one from About.
The rationale for these, in order: entries and authors have to do with
entries and most of the help involves entries. It also has to do with
website but in 'about' it does not seem the right place, unless maybe it
is renamed to 'Credits' or something (I am not suggesting this one way
or the other). This one is debatable but that was the rationale.

The Status menu has been extended to have: Markdown guidelines and
Security policy. The rationale is that the markdown guidelines are part
of contest guidelines and the security policy is about the status of the
entries and how if there are any security problems they will not be
addressed (instead of about the IOCCC).

The FAQ was extended to have: Compiling entries, Running entries, How to
help. The reason to not have compiling and running entries under Entries
is because this is 'how to' and also the menu was too long. How to help
seems like a good idea under FAQ too (was in About).

About was extended to have the new 'about.html' page (from about.md).
This is a rare case where a new file is useful as it fits under 'About'.
The menu now is: Home page, About the IOCCC, The Judges, Contact us. I
was pondering the 'About [the IOCCC]' at the top and also naming it
'About us' but it seemed like a link to index.html was necessary and as
for 'about us' it seemed less clear as to whether it was about the
judges or the contest itself. The FAQ has been updated slightly for
this.

After further inspection the bin/index.html and the inc/index.html links
were removed from the about section.

With these changes, renaming an item or slight reordering
notwithstanding, I believe that #2006 is probably in good shape.
This commit is contained in:
Cody Boone Ferguson committed 2024-10-25 11:23:21 -07:00
1 parent 75c89bd544
commit af5482825c
421 files changed
+36559 -29682

No files matched your search

+38 -2
View File
@@ -337,6 +337,8 @@ help:
@echo '# Rules for building specific web pages, a subset of rules mentioned above:'
@echo
@echo 'make bugs ;: generate bugs.html'
@echo 'make about ;: generate about.html'
@echo 'make contact ;: generate contact.html'
@echo 'make faq ;: generate faq.html'
@echo 'make guidelines ;: generate next/guidelines.hmtl'
@echo 'make markdown ;: generate markdown.hmtl'
@@ -618,6 +620,34 @@ test:
.PHONY: thanks bugs gen_next rules guidelines faq
# generate about.html
#
# What is this all about? It is better that you do not decipher what this is all
# about because if anyone ever does discover exactly what the IOCCC is for and
# why it is here, it will instantly disappear and be replaced by something even
# more bizarre and inexplicable!
#
about: ${GEN_TOP_HTML} about.md
@echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
@echo "You wonder what this is all about?"
@${GEN_TOP_HTML} about
@echo
@echo "You better not, because if you find out,"
@echo "it will instantly be replaced by something"
@echo "even more bizarre and inexplicable!"
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
# generate contact.html
#
contact: ${GEN_TOP_HTML} contact.md
@echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
@echo "You wish to make contact with the IOCCC Judges?"
@${GEN_TOP_HTML} contact
@echo
@echo "I hope you're used to confused aliens!"
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
# generate thanks-for-help.html
#
# So Long, and Thanks for All the Fish :-)
@@ -657,7 +687,10 @@ gen_next: ${GEN_TOP_HTML} next/README.md next/guidelines.md next/rules.md
markdown: ${GEN_TOP_HTML} markdown.md
@echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
${GEN_TOP_HTML} -v 1 markdown
@echo "You want to markdown?"
@${GEN_TOP_HTML} markdown
@echo
@echo "Careful that we don't mark down your submission!"
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
rules: ${GEN_TOP_HTML} next/rules.md
@@ -672,7 +705,10 @@ guidelines: ${GEN_TOP_HTML} next/guidelines.md
security: ${GEN_TOP_HTML} SECURITY.md
@echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
${GEN_TOP_HTML} -v 1 SECURITY
@echo "You wish to make IOCCC entries secure?"
@${GEN_TOP_HTML} SECURITY
@echo
@echo "We also didn't want Pluto demoted!"
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='