jwogrady Work, evidence, and what I make of it
Lab note JRN 26-011done

A theme that refuses to build, and why I came around to it

An unset timeZone fails the build outright. I was annoyed for about a minute.

What happened

  • The theme hard-fails with no timeZone in config.
  • Not a warning — a failed build, on a line I hadn’t written yet.
  • My first reaction was irritation, and I want to record that honestly, because I’ve been on the other side of this argument.
  • A library that refuses to start over a missing config line is infuriating in the moment.

What it’s preventing

  • Then I worked out what it’s preventing.

  • Unset, Hugo uses the build machine’s zone.

  • An entry filed at 00:17 UTC is September 20 on a CI runner and September 19 on my laptop.

  • The same commit produces two different sites, and an entry gets filed under a day its own archive page doesn’t cover.

  • That isn’t a bug you find. It’s a bug you notice, months later, in an index that’s been quietly wrong the whole time.

  • The fix is two lines:

    timeZone = 'America/Chicago'
    [params.spectrum]
      timezone = 'America/Chicago'   # must match
    

The rule I take away

  • Fail hard when the alternative is silent and plausible.
  • A crash costs a minute.
  • A plausible wrong answer costs however long it takes to notice — and the whole point is that nothing makes you notice.