Skip to content

feat(docs): add OG/social-preview image so shared links unfurl as a card #157

Description

@benjamineckstein

Problem. No og:image/twitter:image; twitter:card is summary, so every shared link unfurls as a bare text card. The infographic SVGs already exist, so the asset is built — just not wired.

Evidence. docs/astro.config.mjs grep for og:image|twitter:image|summary_large ⇒ none; head shows twitter:card = summary. Assets at docs/public/media/infographic-{light,dark}.svg.

Fix. rsvg-convert the infographic to a 1200x630 PNG; add og:image + twitter:image in the astro head; switch twitter:card to summary_large_image; upload the same PNG as the GitHub repo social preview. Prerequisite for the MARKETING.md launch sequence.

Done when. A shared docs/repo link previews with the image; social validators pass.


Filed from a repo-wide improvement audit; every claim was adversarially verified against source.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationmarketingPositioning, distribution, content

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions