kestra-io / kestra-io/docs

[Bash2.0] Docs pages have no working social preview image

Open
#5,381 0 comments 0 reactions 0 assignees View on GitHub
area/docs kind/website
Dominant language
Astro
Stars
155
Forks
177
Avg merge
1d 20m
Merged PRs (30d)
192

Description

## Describe the issue

Every docs page claims to have its own social preview image, but none of them really do. They all quietly fall back to the same generic Kestra image. So when you share a docs link in Slack, X, or LinkedIn, they all look the same instead of showing a preview for that page.

## Steps to reproduce

**1.** Open any docs page, say `kestra.io/docs/tutorial/fundamentals`.

**2.** Look at the page source and find the `og:image` tag. It points at `kestra.io/meta/docs/tutorial/fundamentals.svg`.

**3.** Open that image link.

## Actual behaviour

It doesn't load a page image, it bounces to the generic `kestra.io/og-image.png`. Same story on every docs page I tried: each one asks for its own `/meta/docs/.../.svg`, and each one just ends up on the generic image. So the per-page image is set up everywhere but never actually made.

## Expected behaviour

- Either make the per-page images so each docs page gets its own preview, or just point `og:image` at the generic image and drop the dead per-page links.

## Environment

- Site: kestra.io (docs)

Contributor guide

Open the contributing guide

Research direction

Start by inspecting the page source for kestra.io/docs/tutorial/fundamentals and trace how its og:image URL is produced. Check why the referenced /meta/docs/tutorial/fundamentals.svg resolves to the generic og-image.png. Done means either each docs page resolves to its intended preview image or all pages consistently use the generic image without dead per-page links.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.