Skip to content

docs(impl): the OG card names the wrong project - #100

Merged
ajbarea merged 1 commit into
mainfrom
docs/og-card-brief
Sep 20, 2026
Merged

ajbarea merged 1 commit into
mainfrom
docs/og-card-brief

Conversation

@ajbarea

@ajbarea ajbarea commented Sep 20, 2026

Copy link
Copy Markdown
Owner

docs/assets/phalanx-og.png is the image every Slack, LinkedIn and X unfurl of a Phalanx link has been showing. It reads:

InteFL — Federated learning, under fire — 10 strategies · 6 attacks · Byzantine-robust

That is IntelliFL's name and IntelliFL's figures. The two projects are deliberately separate, and none of those three claims describes this one, whose line is federated learning on the latest Flower, with OpenTelemetry-native observability. The card also carries github.com/ajbarea/phalanx-fl beneath the wrong wordmark, so it reads as though the two are the same thing.

This records the correction and the brief to regenerate it. No asset change yet — the card needs generating, same as the hero.

Two things worth noting in the brief:

Burning the wordmark and tagline into the card is correct and stays. I expected the opposite, since overrides/main.html already emits og:title and og:description — but the text a platform renders beside an unfurl varies and several render none, so a self-carrying card is the current convention. What changes is which project it names, not whether it names one.

The card is not a cropped hero. It renders around 500px wide in a feed, where the hero's many-small-nodes field turns to mush. The brief asks for fewer, larger nodes and one focal point, keeping the same cyan/violet emission so the card and the site still read as one thing. Type is composited after the art rather than prompted into it, because image models still set text unreliably.

Sources for the 2026 conventions (1200x630 at 1.91:1, centre safe area, PNG for graphics-with-text): OG image sizes 2026, OG image best practices.

phalanx-og.png reads "InteFL - Federated learning, under fire - 10
strategies, 6 attacks, Byzantine-robust". Those are IntelliFL's name and
IntelliFL's figures, so every unfurl of a Phalanx link has been advertising
a different project, and none of the three claims describes this one.

Records the correction, the art prompt, and the type to set over it.
Burning the wordmark in stays: the text a platform renders beside an unfurl
varies and some render none, so the card carries its own.
@ajbarea ajbarea added the documentation Improvements or additions to documentation label Sep 20, 2026
@ajbarea ajbarea self-assigned this Sep 20, 2026
@ajbarea
ajbarea enabled auto-merge (squash) September 20, 2026 18:56
@ajbarea
ajbarea merged commit da0a4c5 into main Sep 20, 2026
10 checks passed
@ajbarea
ajbarea deleted the docs/og-card-brief branch September 20, 2026 18:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant