diff --git a/inc/README.md b/inc/README.md
new file mode 100644
index 000000000..2b6aaa2c6
--- /dev/null
+++ b/inc/README.md
@@ -0,0 +1,194 @@
+# inc
+
+The [inc](/inc) directory holds content that is used by the
+[build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
+
+**HOWEVER ...** XXX
+
+While the build-ioccc repo is not ready, tools under
+[temp-test-ioccc repo tmp directory](https://github.com/ioccc-src/temp-test-ioccc/tree/master/tmp)
+will use files in this directory.
+
+
+##  Why the name inc?
+
+We use inc because "include" would be misleading for both C and because
+the contents of HTML files under [inc](/inc) is not really included
+by the web server nor the browser.  Content of HTML files is
+processed by tools in the [build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master).
+Processing can include substitution of strings of the form _%%CURDS%%_ with some command
+line supplied value by the tool in question.
+
+
+## How HTML content is built
+
+Files under the [inc](/inc) directory contain HTML fragments that the
+[build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
+tools use to form HTML content for the official IOCCC web site](https://www.ioccc.org).
+
+The canonical way that HTML content is built uses, by default, files of the form:
+
+```
+*.default.html
+```
+
+The command line of a [build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
+tool, and perhaps modified via [exception file](/inc.exception.md) file may change
+to using a different filename, such as using `body.graybg.html` instead of the default `body.default.html`.
+In some cases the [exception file](/inc.exception.md) may disable forming HTML content altogether.
+
+The following is the canonical order for building HTML content from a winner `README.md` file:
+
+0. top.default.html
+1. head.default.html
+2. body.default.html
+3. before-row.default.html
+4. page-top.default.html
+5. before-row.default.html
+6. before-leftcolumn.default.html
+7. sidenav.default.html
+8. before-rightcolumn.default.html
+9. before-content.default.html
+
+At this point, page content such as that produced by the `pandoc` tool is inserted.
+This is followed by canonical order for the end of the HTML content:
+
+10. after-content.default.html
+11. after-rightcolumn.default.html
+12. after-row.default.html
+13. page-bottom.default.html
+14. bottom.default.html
+
+In some cases, the above canonical order may be skipped.
+
+Files of the form will **NOT** exist, instead the tool will skip using such a file:
+
+```
+*.devnull.html
+```
+
+
+
+
+## Use CAUTION when modifying inc files
+
+Some of the files under this directory are used to form **MOST** of the HTML content
+on the [official IOCCC web site](https://www.ioccc.org):
+
+**HOWEVER ...** XXX
+
+Well, until the [official IOCCC web site](https://www.ioccc.org), via the
+[IOCCC winner repo](https://github.com/ioccc-src/winner) is ready for the mass pull request/merge,
+these files are used to form **MOST** of the HTML content
+on the [experimental web site](https://ioccc-src.github.io/temp-test-ioccc/).
+
+... and in particular files under [inc](/inc) that are of the form (called default HTML files) ...:
+
+```
+*.default.html
+```
+
+... contain default content used to form IOCCC HTML / IOCCC web pages.
+
+Instead of editing the default HTML files in order to fix a special web page,
+consider making a copy of the default file and modifying the [use.md](/inc/use.md)
+file to refer to the copy instead.  That way your special case situation will
+not impact **MOST** of the HTML content.
+
+
+## Why do we do not use certain well know HTML technology
+
+You may wonder why we need these files in the first place.
+You may wonder why we even need the tools in the
+[build-ioccc repo](https://github.com/ioccc-src/build-ioccc/tree/master)
+when there other solutions available to form web pages.
+
+
+### <a name="static-only"></a>Static web pages only
+
+Here are some reasons why we are using these files and
+special tools to create HTML content / IOCCC web pages:
+
+We host [official IOCCC web site](https://www.ioccc.org) via [GitHub pages](https://pages.github.com).
+As of the time this file written, **only static web pages are supported**.
+
+
+### Cannot use server side include
+
+We use [static web pages](#static-only), so use of "server side include" is not available to the IOCCC.
+
+For example, Apache SSI "#include" does not work on [GitHub pages](https://pages.github.com).
+
+
+### Cannot use a back-end database
+
+We use [static web pages](#static-only), so use of "back-end database" is not available to the IOCCC.
+
+
+### <a name="why-github"></a>Cannot use non-GitHub web servers
+
+The [GitHub pages](https://pages.github.com) have the distributed server capacity needed to handle
+the **huge download volume** or [Slashdot effect](https://en.wikipedia.org/wiki/Slashdot_effect)
+that happens when a IOCCC winners are published.
+
+Most so-called low cost web hosting sites have a somewhat hidden excessive bandwidth charge
+and/or cap bandwidth when the volume gets too high, and/or do not have the infrastructure
+that can handle the [Slashdot effect](https://en.wikipedia.org/wiki/Slashdot_effect).
+
+The IOCCC had experience with people offering web mirrors and even free hosting
+only to find that the generous benefactor moves on, or their service is purchased
+by someone else who is not so generous.  While it is possible that GitHub might someday
+suffer a similar fate, for the time being we are betting that GitHub will remain
+willing to host the IOCCC.
+
+The [official IOCCC web site](https://www.ioccc.org) is, after all, primarily C source code
+with some supporting documentation.  As such it is a natural fit for GitHub and
+[GitHub pages](https://pages.github.com).
+
+
+### cannot use the HTML object tag
+
+The _<_ object _>_ HTML tag does not work for our needs.
+
+The browser context relationship between the HTML content holds the
+HTML tag does not extend into the content that the tag includes.
+For example, menu bars will not operate as specified by the [ioccc CSS](/ioccc.css).
+
+
+### cannot use the HTML embed tag
+
+The _<_ embed _>_ HTML tag does not work for our needs.
+
+This tag wants one to specify the _width_ and _height_ in pixels.
+Use of a percentage is not officially supported even if some browsers
+might do so.  Our Responsive Web Design on the [ioccc CSS](/ioccc.css)
+needs to be responsive to small-sized cell phone-like screens,
+mid-sized table-like screens, as well as large-sized desktop-like screens.
+Specifying a _width_ and _height_ in pixels will not work well in
+all of those screen size contexts.
+
+
+### cannot use the HTML iframe tag
+
+The _<_ iframr _>_ HTML tag does not work for our needs.
+
+This tag wants one to specify the _width_ and _height_ in pixels.
+Use of a percentage is not officially supported even if some browsers
+might do so.  Our Responsive Web Design on the [ioccc CSS](/ioccc.css)
+needs to be responsive to small-sized cell phone-like screens,
+mid-sized table-like screens, as well as large-sized desktop-like screens.
+Specifying a _width_ and _height_ in pixels will not work well in
+all of those screen size contexts.
+
+
+### cannot use JavaScript to include content
+
+We do not use JavaScript to include HTML content.
+
+While the IOCCC may use JavaScript in the future to directly render things like C source code,
+we will do so in such a way that someone will be able to view [official IOCCC web site](https://www.ioccc.org)
+content with JavaScript disabled.
+
+The IOCCC will **NOT MANDATE USE OF JavaScript** to view [official IOCCC web site](https://www.ioccc.org).
+
+For this reason, we cannot use JavaScript include HTML content.
diff --git a/inc/after-content.default.html b/inc/after-content.default.html
new file mode 100644
index 000000000..c2606643d
--- /dev/null
+++ b/inc/after-content.default.html
@@ -0,0 +1,3 @@
+<!-- START: this line start content from: /inc/after-content.default.html -->
+
+<!-- END: this line ends content from: /inc/after-content.default.html -->
diff --git a/inc/after-rightcolumn.default.html b/inc/after-rightcolumn.default.html
new file mode 100644
index 000000000..19b96416a
--- /dev/null
+++ b/inc/after-rightcolumn.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/after-rightcolumn.default.html -->
+
+  </div>
+
+<!-- END: this line ends content from: /inc/after-rightcolumn.default.html -->
diff --git a/inc/after-row.default.html b/inc/after-row.default.html
new file mode 100644
index 000000000..c44215ca5
--- /dev/null
+++ b/inc/after-row.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/after-row.default.html -->
+
+</div>
+
+<!-- END: this line ends content from: /inc/after-row.default.html -->
diff --git a/inc/before-content.default.html b/inc/before-content.default.html
new file mode 100644
index 000000000..90d362bf6
--- /dev/null
+++ b/inc/before-content.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/before-content.default.html -->
+
+    <a name="content"></a>
+
+<!-- END: this line ends content from: /inc/before-content.default.html -->
diff --git a/inc/before-leftcolumn.default.html b/inc/before-leftcolumn.default.html
new file mode 100644
index 000000000..33fa6350f
--- /dev/null
+++ b/inc/before-leftcolumn.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/before-leftcolumn.default.html -->
+
+  <div class="leftcolumn">
+
+<!-- END: this line ends content from: /inc/before-leftcolumn.default.html -->
diff --git a/inc/before-rightcolumn.default.html b/inc/before-rightcolumn.default.html
new file mode 100644
index 000000000..4eb448669
--- /dev/null
+++ b/inc/before-rightcolumn.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/before-rightcolumn.default.html -->
+
+  <div class="rightcolumn">
+
+<!-- END: this line ends content from: /inc/before-rightcolumn.default.html -->
diff --git a/inc/before-row.default.html b/inc/before-row.default.html
new file mode 100644
index 000000000..70816a7f8
--- /dev/null
+++ b/inc/before-row.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/before-row.default.html -->
+
+<div class="row">
+
+<!-- END: this line ends content from: /inc/before-row.default.html -->
diff --git a/inc/body.default.html b/inc/body.default.html
new file mode 100644
index 000000000..fca1ca205
--- /dev/null
+++ b/inc/body.default.html
@@ -0,0 +1,5 @@
+<!-- START: this line start content from: /inc/body.default.html -->
+
+<body>
+
+<!-- END: this line ends content from: /inc/body.default.html -->
diff --git a/inc/bottom.default.html b/inc/bottom.default.html
new file mode 100644
index 000000000..48a0383c7
--- /dev/null
+++ b/inc/bottom.default.html
@@ -0,0 +1,6 @@
+<!-- START: this line start content from: /inc/bottom.default.html -->
+
+</body>
+</html>
+
+<!-- END: this line ends content from: /inc/bottom.default.html -->
diff --git a/inc/head.default.html b/inc/head.default.html
new file mode 100644
index 000000000..6be98d389
--- /dev/null
+++ b/inc/head.default.html
@@ -0,0 +1,12 @@
+<!-- START: this line start content from: /inc/head.default.html -->
+
+<head>
+<link rel="stylesheet" href="%%DOCROOT_URL_SLASH%%ioccc.css">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+<title>%%TITIE%%</title>
+<meta name="description" content="%%DESCRIPTION%%">
+<meta name="keywords" content="%%KEYWORDS%%">
+</head>
+
+<!-- END: this line ends content from: /inc/head.default.html -->
diff --git a/inc/page-bottom.default.html b/inc/page-bottom.default.html
new file mode 100644
index 000000000..a88d9d788
--- /dev/null
+++ b/inc/page-bottom.default.html
@@ -0,0 +1,14 @@
+<!-- START: this line start content from: /inc/page-bottom.default.html -->
+
+<div class="footer">
+
+  <hr>
+
+  <h2>Footer</h2>
+
+  <p>This is where stuff at the bottom of all pages would be found.</p>
+
+  <a href="#top">Jump to top</a>
+</div>
+
+<!-- END: this line ends content from: /inc/page-bottom.default.html -->
diff --git a/inc/page-top.default.html b/inc/page-top.default.html
new file mode 100644
index 000000000..a301a4e5c
--- /dev/null
+++ b/inc/page-top.default.html
@@ -0,0 +1,9 @@
+<!-- START: this line start content from: /inc/page-top.default.html -->
+
+<div class="header">
+  <img src="%%DOCROOT_URL_SLASH%%png/ioccc.png" alt="IOCCC image by Matt Zucker" width=300 height=110>
+  <h1>%%HEADER_1%%</h1>
+  <h2>%%HEADER_2%%</h2>
+</div>
+
+<!-- END: this line ends content from: /inc/page-top.default.html -->
diff --git a/inc/sidenav.default.html b/inc/sidenav.default.html
new file mode 100644
index 000000000..e9d9a6a96
--- /dev/null
+++ b/inc/sidenav.default.html
@@ -0,0 +1,32 @@
+<!-- START: this line start content from: /inc/sidenav.default.html -->
+
+    <div class="sidenav">
+      <a href="#content">Jump to contents</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="%%DOCROOT_URL_SLASH%%index.html">IOCCC Home</a>
+      <a href="%%DOCROOT_URL_SLASH%%years.html">Winning Entries</a>
+      <a href="%%DOCROOT_URL_SLASH%%winners.html">People who have won</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="%%DOCROOT_URL_SLASH%%news.html">IOCCC News</a>
+      <a href="%%DOCROOT_URL_SLASH%%judges.html">The IOCCC Judges</a>
+      <a href="%%DOCROOT_URL_SLASH%%contact.html">Contacting the IOCCC</a>
+      <a href="%%DOCROOT_URL_SLASH%%faq.html">FAQ</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="%%DOCROOT_URL_SLASH%%faq.html#fix_a_winner">Fixing IOCCC winners</a>
+      <a href="%%DOCROOT_URL_SLASH%%faq.html#fix_web_site">Fixing the web site</a>
+      <a href="%%DOCROOT_URL_SLASH%%bugs.html">Bugs &amp; (mis)features</a>
+      <a href="%%DOCROOT_URL_SLASH%%thanks-for-fixes.html">Thanks for the fixes</a>
+    </div>
+    <hr>
+    <div class="sidenav">
+      <a href="#top">Jump to top</a>
+    </div>
+  </div>
+
+<!-- END: this line ends content from: /inc/sidenav.default.html -->
diff --git a/inc/top.default.html b/inc/top.default.html
new file mode 100644
index 000000000..cf5471bf8
--- /dev/null
+++ b/inc/top.default.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!-- START: two lines up starts content from: /inc/top.default.html -->
+<!-- -->
+<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
+<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
+<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
+<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
+<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
+<!-- -->
+<!-- END: this line ends content from: /inc/top.default.html -->
diff --git a/inc/topnav.default.html b/inc/topnav.default.html
new file mode 100644
index 000000000..dc97ef40a
--- /dev/null
+++ b/inc/topnav.default.html
@@ -0,0 +1,9 @@
+<!-- START: this line start content from: /inc/topnav.default.html -->
+
+<div class="topnav">
+  <a href="%%LEFT_LINK%%">&larr; %%LEFT_TEXT%%</a>
+  <a href="%%UP_LINK%%">&uarr; %%UP_TEXT%% &uarr;</a>
+  <a href="%%RIGHT_LINK%%">%%RIGHT_TEXT%% &rarr;</a>
+</div>
+
+<!-- END: this line ends content from: /inc/topnav.default.html -->