Skip to content

docs: record the page walk — what it found and why greps could not - #392

Merged
catomean merged 1 commit into
mainfrom
docs/backlog-2
Aug 26, 2026
Merged

docs: record the page walk — what it found and why greps could not#392
catomean merged 1 commit into
mainfrom
docs/backlog-2

Conversation

@catomean

Copy link
Copy Markdown
Collaborator

The backlog described two rounds; there have been three. The third came from opening all 33 public pages in a browser instead of reading the code, and the distinction matters enough to write down.

Greps and typechecks were green throughout, while the site was serving:

  • donation buttons pointing at another organisation's Ko-fi and GitHub Sponsors
  • two nav entries rendering <a href="">
  • a 404 in the live FAQ
  • "16+ Jahre Knowhow" on an organisation founded in 2026
  • a price wrapping onto two lines
  • three different causes of one doubled page title

Records what the refocus settled (services catalogue, Über uns, navGroup as the placement SSOT) so it isn't re-litigated, and adds the four gates from this pass — each mutation-proved, because a gate that has never been seen red is a claim rather than a check.

Two items promoted to "needs a human decision"

Both because they're claims about the world that the repository cannot answer:

  • Praktikum + Wiedereinstieg name HEKS, AOZ and two municipalities as partners. If evig runs those programmes they belong with pillar 4 and deserve prominence; if they came across with the code, naming four real organisations is worse than merely off-thesis.
  • /karriere is invisible to nav, footer and sitemap, and carries the only hardcoded-German PageHero on the site — so it's also the one page that cannot be translated.

Education stated as the biggest gap

Not a bullet any more. Teaching is meant to be a large part of what evig does, and /workshops renders "0 Workshops" while /blog renders nothing.

The seeded workshops use legacy category strings matching none of the ten canonical ids, are written in formal "Sie" against the site's informal "du", and have no instances outside e2e-seed.ts — so even with rows there would be no dates and no registration possible.

New process notes

  • A cancelled deploy is not a failed one. A newer merge supersedes it, and a watcher checking only "not success" cries wolf.
  • Measure the rendered output, don't reason about the framework. Two of the three doubled titles were missed by reasoning about Next's title.template resolution and found by curling <title>.

Docs-only. lint:docs holds at 68/68 baseline with 0 in the primary docs.

🤖 Generated with Claude Code

The backlog described two rounds; there have been three. The third came from
opening all 33 public pages in a browser instead of reading the code, and the
distinction matters enough to write down: greps and typechecks were green
throughout, while the site was serving donation buttons pointing at another
organisation, two nav entries rendering <a href="">, a 404 in the live FAQ,
a tenure claim on an org founded two years ago, and three different causes of
one doubled page title.

Records what the refocus settled (services catalogue, Über uns, navGroup as
the placement SSOT) so it is not re-litigated, and adds the four gates from
this pass — each mutation-proved, because a gate that has never been seen red
is a claim rather than a check.

Two items promoted to "needs a human decision", both because they are claims
about the world that the repository cannot answer:

  - Praktikum + Wiedereinstieg name HEKS, AOZ and two municipalities as
    partners. If evig runs those programmes they belong with pillar 4 and
    deserve prominence; if they came across with the code, naming four real
    organisations is worse than merely off-thesis.
  - /karriere is invisible to nav, footer and sitemap, and carries the only
    hardcoded-German PageHero on the site, so it is also the one page that
    cannot be translated.

And education is now stated as the biggest gap rather than a bullet: George
has said teaching will be a large part of what evig does, and /workshops
renders "0 Workshops" while /blog renders nothing. The seeded workshops use
legacy category strings matching none of the ten canonical ids, are written
in formal "Sie" against the site's "du", and have no instances outside
e2e-seed.ts — so even with rows there would be no dates and no registration.

New process notes: a cancelled deploy is not a failed one (a newer merge
supersedes it, and a watcher checking only "not success" cries wolf), and
measure the rendered output rather than reasoning about the framework — two
of the three doubled titles were missed by reasoning about Next's
title.template and found by curling <title>.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@catomean
catomean merged commit 5666fa5 into main Aug 26, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant