Skip to content

Fix docs images by enabling LFS in checkout#144

Merged
RafaelPo merged 4 commits intomainfrom
fix/docs-images-lfs
Feb 12, 2026
Merged

Fix docs images by enabling LFS in checkout#144
RafaelPo merged 4 commits intomainfrom
fix/docs-images-lfs

Conversation

@RafaelPo
Copy link
Contributor

@RafaelPo RafaelPo commented Feb 12, 2026

Summary

  • Images on /docs/active-learning-llm-oracle and /docs/scale-deduplication-20k-rows are not rendering
  • Root cause: the deploy workflow checkout (actions/checkout@v4) doesn't fetch LFS objects by default, so PNGs are deployed as pointer text files
  • Fix: add lfs: true to the checkout step so LFS objects are fetched during build
  • Removed duplicate images from docs/images/ — they only need to live in docs-site/public/images/

Test plan

  • Verify both images render on the live docs site after deploy

🤖 Generated with Claude Code

PNGs were stored as LFS pointers. The deploy workflow checkout doesn't
fetch LFS objects, so images were deployed as pointer text files.

Removed *.png from .gitattributes LFS tracking and re-added the image
files as regular git objects. They're small enough (326KB + 116KB)
to store directly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@RafaelPo RafaelPo force-pushed the fix/docs-images-lfs branch from 469d524 to 27db5a6 Compare February 12, 2026 15:33
Images only need to live in docs-site/public/images/ where Next.js
serves them as static assets.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@RafaelPo RafaelPo requested a review from hnykda February 12, 2026 15:36
RafaelPo and others added 2 commits February 12, 2026 15:46
Restores *.png to LFS tracking. Adds lfs: true to the deploy workflow
checkout so LFS objects (images, CSVs) are fetched during build.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Reference images via media.githubusercontent.com URLs so the browser
fetches them directly from GitHub's LFS CDN. This avoids needing
lfs: true in the deploy workflow checkout.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@RafaelPo RafaelPo merged commit 5f400d7 into main Feb 12, 2026
3 checks passed
@RafaelPo RafaelPo deleted the fix/docs-images-lfs branch February 12, 2026 15:54
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