Use compact summary link-preview card and crisp 512px OG icons

Shared links rendered a giant image dumped below the text (Discord) because twitter:card was
summary_large_image. Switch to summary so Discord/Slack/X show the compact card with a small icon
thumbnail beside the text (PyPI-style). Regenerate all Open Graph icons at 512x512 (rasterized from
the brand product SVGs onto a white square; replaces the 128px versions that were below the ~200px
thumbnail minimum) and declare og:image:width/height/type/alt. Teams' stale preview is its own cache
and refreshes separately.

Author: vladimir-litvinchik

CHANGELOG.md

@@ -10,12 +10,14 @@ tags), so changes accumulate under **[Unreleased]**.
 ## [Unreleased]
 
 ### Added
-- **Branded link previews (Open Graph / Twitter Card images)** — shared links (Teams, Slack, LinkedIn, etc.)
-  now show a GroupDocs image instead of a generic placeholder: the GroupDocs symbol on the site root/home and
-  the product's own icon on each product build. `og:image` was previously empty (the `utils/featured` resolver
-  fell back to `Site.Params.images`, which was unset because the config key sits under `[params.meta]`); the
-  resolver now derives the image from the build (product key = first path segment of the URL). Icons live in
-  theme static at `/img/og/` (GroupDocs symbol + 15 product PNGs).
+- **Branded link previews (Open Graph / Twitter Card images)** — shared links (Teams, Slack, LinkedIn, Discord,
+  etc.) now show a GroupDocs image instead of a generic placeholder: the GroupDocs symbol on the site root/home
+  and the product's own icon on each product build. `og:image` was previously empty (the `utils/featured`
+  resolver fell back to `Site.Params.images`, which was unset because the config key sits under `[params.meta]`);
+  the resolver now derives the image from the build (product key = first path segment of the URL). The card uses
+  the compact `summary` Twitter Card (small icon thumbnail beside the text) rather than `summary_large_image`, and
+  the icons are crisp **512×512** PNGs (rasterized from the brand product SVGs onto a white square) with
+  `og:image:width`/`height`/`type`/`alt` declared. Icons live in theme static at `/img/og/`.
 - **Verified getting-started code** on the family pages — the "Getting started" tabs now render real
   snippets from `data/getting_started.yaml` (keyed product → platform), sourced from the official
   products content and **compile-verified against the real SDKs** by runnable apps under

themes/docs/layouts/partials/microformats/opengraph.html

@@ -11,6 +11,10 @@
 {{- end }}
 {{- with partial "utils/featured" . }}
   <meta property="og:image" content="{{ . }}" />
+  <meta property="og:image:type" content="image/png" />
+  <meta property="og:image:width" content="512" />
+  <meta property="og:image:height" content="512" />
+  <meta property="og:image:alt" {{ partial "utils/title" $ | printf "content=%q" | safeHTMLAttr }} />
 {{- end }}
 {{- with partial "utils/description" . }}
   <meta property="og:description" content="{{ . | plainify | htmlUnescape | chomp }}" />

themes/docs/layouts/partials/microformats/twitter_cards.html

@@ -1,8 +1,6 @@
-{{- with partial "utils/featured" . }}
-  <meta name="twitter:card" content="summary_large_image" />
-{{- else }}
-  <meta name="twitter:card" content="summary" />
-{{- end }}
+{{- /* Compact card: a small icon thumbnail on the right of the text (our og:image is a square brand
+       icon, not a 1.91:1 hero), matching how Discord/Slack/X render PyPI-style links. */}}
+<meta name="twitter:card" content="summary" />
 <meta name="twitter:title" {{ partial "utils/title" . | printf "content=%q" | safeHTMLAttr }} />
 {{- with partial "utils/featured" . }}
   <meta property="twitter:image" content="{{ . }}" />