6 files changed, 19 insertions, 22 deletions
diff --git a/content/templates/base.html b/content/templates/base.html
index e35098c..237c398 100644
--- a/content/templates/base.html
+++ b/content/templates/base.html
@@ -1,9 +1,9 @@
-{# Page layout for orgo, mirroring theme/templates/base.html.
+{# Page layout for the site.
 
    Styling comes from theme/static/styles.css, published by `[build] assets` in
-   orgo.toml — the same directory weblorg serves at /, read in place rather than
-   copied. weblorg links the minified styles.min.css instead; that file is gitignored
-   build output and the rules are the same, so this links the tracked one.
+   orgo.toml and read in place rather than copied. It is served as authored: at ~1KB,
+   minifying it saved 52 bytes over the wire once compressed, which did not pay for a
+   build step and a toolchain dependency.
 
    Available here: page (.title .url .source .date .date_iso .tags .excerpt .toc
    .keywords), site, nav, root, stylesheet. See the orgo guide on Templates. #}
@@ -45,8 +45,8 @@
 <link rel="alternate" type="application/rss+xml" title="{{ site.title }}" href="{{ root }}feed.xml">
 <link rel="stylesheet" href="{{ root }}styles.css" type="text/css">
 <link rel="icon" href="data:,">
-{#- rel="me" identity links. weblorg's base.html writes the last one as <a>, which a
-    browser hoists out of <head>; <link> is the spelling that stays where it is put. #}
+{#- rel="me" identity links, spelled as <link> rather than <a>: a browser hoists a
+    stray <a> out of <head>, while <link> stays where it is put. #}
 <link href="https://github.com/ccleberg" rel="me">
 <link href="https://gitlab.com/ccleberg" rel="me">
 <link href="mailto:[email protected]" rel="me">
diff --git a/content/templates/blog.html b/content/templates/blog.html
index 17f8870..ecb5c5d 100644
--- a/content/templates/blog.html
+++ b/content/templates/blog.html
@@ -1,5 +1,5 @@
-{# The blog index at /blog/, mirroring theme/templates/blog.html.
-   Separate from list.html because the live page carries its own prose. #}
+{# The blog index at /blog/.
+   Separate from list.html because the page carries its own prose. #}
 {% extends "base.html" %}
 
 {#- Group the list under year headings, as the live site does. Set to false for one flat
diff --git a/content/templates/feed.xml b/content/templates/feed.xml
index fa761b8..7596b02 100644
--- a/content/templates/feed.xml
+++ b/content/templates/feed.xml
@@ -1,10 +1,9 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-{#- The RSS feed at /feed.xml, mirroring theme/templates/feed.xml. A feed is read away
-    from the site that served it, so every URL here is absolute — which is what
-    `| absolute` needs [site] base_url for.
+{#- The RSS feed at /feed.xml. A feed is read away from the site that served it, so
+    every URL here is absolute — which is what `| absolute` needs [site] base_url for.
 
-    <description> carries each post's full rendered HTML, as weblorg's feed does — the
-    collection sets `include_content` to ask for it. #}
+    <description> carries each post's full rendered HTML — the collection sets
+    `include_content` to ask for it. #}
 <rss version="2.0"
      xmlns:content="http://purl.org/rss/1.0/modules/content/"
      xmlns:dc="http://purl.org/dc/elements/1.1/"
diff --git a/content/templates/garden.html b/content/templates/garden.html
index dc669a2..113128a 100644
--- a/content/templates/garden.html
+++ b/content/templates/garden.html
@@ -1,4 +1,4 @@
-{# The garden index at /garden/, mirroring theme/templates/garden.html.
+{# The garden index at /garden/.
    Notes are listed by title and description rather than by date. #}
 {% extends "base.html" %}
 {% block main %}
diff --git a/content/templates/home.html b/content/templates/home.html
index 6d280ee..6a2cf33 100644
--- a/content/templates/home.html
+++ b/content/templates/home.html
@@ -1,9 +1,8 @@
 {# The home page: authored prose plus the most recent posts.
 
    A generated page, so it has no source .org file — `pages` holds the blog collection's
-   entries, newest first, and the prose lives here. This mirrors what weblorg's
-   theme/templates/index.html does today, including its bare <title>: the home page is
-   "cleberg.net" and not "cleberg.net - cleberg.net". #}
+   entries, newest first, and the prose lives here. The <title> is bare on purpose: the
+   home page is "cleberg.net" and not "cleberg.net - cleberg.net". #}
 {% extends "base.html" %}
 {% block subtitle %}{% endblock %}
 {% block main %}
diff --git a/content/templates/tags.html b/content/templates/tags.html
index 5240b27..9b3a1e2 100644
--- a/content/templates/tags.html
+++ b/content/templates/tags.html
@@ -1,11 +1,10 @@
 {# The tag index at /tags/. Receives `groups` — every tag with its count — rather than
    `pages`, because it lists tags and not posts.
 
-   This deliberately differs in shape from the live weblorg page, which is one page with
-   every post inlined under an `#anchor` per tag. Here each tag is its own page, so a tag
-   has a URL worth linking to and the index stays short. The `id` on each entry keeps the
-   old `/tags/#audit` links landing in the right place — they scroll to the tag and its
-   link, rather than 404ing or dumping the reader at the top of a long page. #}
+   Each tag is its own page, so a tag has a URL worth linking to and the index stays
+   short. The `id` on each entry keeps older `/tags/#audit` links landing in the right
+   place — they scroll to the tag and its link, rather than dumping the reader at the
+   top of the index. #}
 {% extends "base.html" %}
 {% block main %}
 <h1>{{ page.title }}</h1>