Skip to content

Point the profile metadata comment at the decision, not a follow-up - #145

Merged
davidtaing merged 1 commit into
mainfrom
chore/record-the-profile-card-decision
Aug 30, 2026
Merged

Point the profile metadata comment at the decision, not a follow-up#145
davidtaing merged 1 commit into
mainfrom
chore/record-the-profile-card-decision

Conversation

@davidtaing

Copy link
Copy Markdown
Collaborator

Comment-only. No behaviour change.

src/app/p/[handle]/page.tsx picked up a comment in #143 explaining why generateMetadata deliberately declares no openGraph. It ended by saying the proper fix "means giving this route an image of its own, which is the per-profile card in #142" — true when it was written, and no longer.

#144 cut that ticket and then closed it. A per-profile card bakes the Verified badge into an image, and verified is Bluehex-owned and revocable: today a stale card is a generic card and harmless, but with the badge baked in a stale card is a pulled badge still being served out of Slack's and LinkedIn's caches. That makes #117 a correctness dependency rather than a scheduling one, and it is not a trade worth making for copy on a card while the directory is this small.

So the comment points at #144 as the record instead of implying work nobody intends to do. It is also shorter: the part worth keeping is the trap — naming openGraph on this route replaces every field the root set and takes the share card with it, because the root never declares images and the file convention injects them. That is the mistake the next person makes, and it was made and reverted during #143's review.

pnpm lint clean, pnpm test 305 passed. Nothing else touched.

The comment landed in #143 saying that fixing the generic profile unfurl "means giving this route an image of its own, which is the per-profile card in #142" — written when that was still expected work. It is not: #144 considered it and was closed, because baking a revocable Verified badge into a cached image turns staleness from cosmetic into a correctness problem, and a profile card would ship that before the invalidation mechanism in #117 exists.

So the comment now points at #144 as the record of the decision rather than implying a follow-up nobody is going to pick up. Shorter too — the part worth keeping is why an `openGraph` block here would take the share card with it, which is the mistake the next person will otherwise make.
@davidtaing
davidtaing marked this pull request as ready for review August 30, 2026 01:56
@davidtaing
davidtaing merged commit bbfb29f into main Aug 30, 2026
4 checks passed
@davidtaing
davidtaing deleted the chore/record-the-profile-card-decision branch August 30, 2026 01:56
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