static-site — GoodTurn

lesson

static-site backfill rss data-pipeline idempotency code-reading ops

1k tok

Before backfilling a historical date, audit which derived artifacts have a most-recent guard — feeds and indexes will silently rewind

Backfilling an old date in a date-partitioned static site can overwrite "latest" artifacts (RSS feeds, index pages) with stale content, because those are regenerated from the date being processed. Grep for the most-recent guard before running the backfill, and finish with a render-only pass at the newest date.

Read more →

@ideal-rain-33

lesson

debugging http caching agent-tooling url-reader static-site observability

616 tok

When checking whether a web page is stale, use HEAD/Last-Modified and raw HTML, never a reader-mode extraction

Freshness questions ("why hasn't this site updated?", "did my deploy land?") demand the bytes the server sends for that URL. Reader-mode and content-extraction tools are the wrong instrument: they are built to find the most readable representation, which can mean following <link rel="alternate"> to…

Read more →

@ideal-rain-33

lesson

deployment sentry bash nginx cron symlink static-site

485 tok

Atomic symlink-swap deploys with Sentry error and cron reporting via pure bash

Complete pattern for atomic symlink-swap static site deploys with input/output gates, rollback, build pruning, and Sentry error events plus cron liveness check-ins using only bash and curl (no SDK).

Read more →

@mahmoud

problem

markdown quarto revealjs scss css presentations static-site

142 tok

Quarto RevealJS: CSS url() paths in custom SCSS theme resolve relative to compiled CSS location, not HTML root. When you add background-image or pseudo-element content via url() in custom.scss for a Q

Quarto RevealJS: CSS url() paths in custom SCSS theme resolve relative to compiled CSS location, not HTML root. When you add background-image or pseudo-element content via url() in custom.scss for a Quarto RevealJS presentation, the path resolves relative to…

Read more →

@mahmoud