diff --git a/Makefile b/Makefile
index 92cc1c7ec..0ae2c24b7 100644
--- a/Makefile
+++ b/Makefile
@@ -341,8 +341,9 @@ help:
@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'
- @echo 'make pw_change ;: generate the next/pw-change.html page'
+ @echo 'make markdown ;: generate markdown.html'
+ @echo 'make remarks ;: generate next/remarks.html'
+ @echo 'make pw_change ;: generate next/pw-change.html'
@echo 'make rules ;: generate next/rules.hmtl'
@echo 'make security ;: generate SECURITY.html'
@echo 'make thanks ;: generate thanks-for-help.html'
@@ -691,6 +692,7 @@ gen_next: ${GEN_TOP_HTML} next/README.md next/guidelines.md next/rules.md next/r
${GEN_TOP_HTML} -v 1 next/guidelines
${GEN_TOP_HTML} -v 1 next/rules
${GEN_TOP_HTML} -v 1 next/register
+ ${GEN_TOP_HTML} -v 1 next/remarks
${GEN_TOP_HTML} -v 1 next/submit
${GEN_TOP_HTML} -v 1 next/pw-change
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
@@ -703,6 +705,11 @@ pw_change: next/pw-change.md
@echo "Perhaps you should change your password!"
@echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
+remarks: ${GEN_TOP_HTML} next/remarks.md
+ @echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
+ @${GEN_TOP_HTML} -v 1 next/remarks
+ @echo '=-=-=-=-= IOCCC complete make $@ =-=-=-=-='
+
markdown: ${GEN_TOP_HTML} markdown.md
@echo '=-=-=-=-= IOCCC begin make $@ =-=-=-=-='
@echo "You want to markdown?"
diff --git a/bin/gen-top-html.sh b/bin/gen-top-html.sh
index 6e4054341..c849b7edc 100755
--- a/bin/gen-top-html.sh
+++ b/bin/gen-top-html.sh
@@ -149,6 +149,7 @@ TOP_MD_SET+=("next/guidelines")
TOP_MD_SET+=("next/pw-change")
TOP_MD_SET+=("next/README")
TOP_MD_SET+=("next/register")
+TOP_MD_SET+=("next/remarks")
TOP_MD_SET+=("next/rules")
TOP_MD_SET+=("next/submit")
TOP_MD_SET+=("nojs-menu")
diff --git a/bin/md2html.cfg b/bin/md2html.cfg
index d5c9551aa..74b281fc4 100644
--- a/bin/md2html.cfg
+++ b/bin/md2html.cfg
@@ -405,6 +405,22 @@ next/register.md
-D
../
+next/remarks.md
+ -H
+ navbar=empty
+ -o
+ bin/subst.default.sh
+ -s
+ TITLE=The International Obfuscated C Code Contest
+ -s
+ DESCRIPTION=Instructions for remarks.md
+ -s
+ KEYWORDS=IOCCC, remarks
+ -s
+ HEADER_2=How to write your remarks.md
+ -D
+ ../
+
next/rules.md
-H
navbar=empty
diff --git a/next/remarks.html b/next/remarks.html
new file mode 100644
index 000000000..ae1b69736
--- /dev/null
+++ b/next/remarks.html
@@ -0,0 +1,519 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Instructions
+
IMPORTANT: be SURE to read the IOCCC rules AND the
+IOCCC guidelines!
+
+Download the
+markdown form of these remarks into your submission’s directory.
+For help with markdown format please see this helpful
+guide.
+Please see and follow the IOCCC markdown
+guidelines. Doing this helps the judges
+integrate your remarks into a README.md, should you win.
+Replace the contents of this remarks.md (in your submission directory) with
+your remarks.
+When packaging your submission with mkiocccentry(1), make sure that the
+remarks.md is in the topdir.
+
+
What should you say?
+
Please see the
+FAQ on “what to put in your remarks”.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/next/remarks.example.md b/next/remarks.md
similarity index 55%
rename from next/remarks.example.md
rename to next/remarks.md
index dbec0609b..29312d696 100644
--- a/next/remarks.example.md
+++ b/next/remarks.md
@@ -1,8 +1,10 @@
# Instructions
-0. Create an empty file `remarks.md` in your submission directory
-(alternatively after reading this file, delete everything in it and rename it
-`remarks.md`).
+**IMPORTANT**: be **SURE** to read the [IOCCC rules](rules.html) **AND** the
+[IOCCC guidelines](guidelines.html)!
+
+0.