Skip to content

docs: align image format guidance with WebP CI enforcement#2786

Open
marcel-rbro wants to merge 2 commits into
masterfrom
docs/image-format-webp
Open

docs: align image format guidance with WebP CI enforcement#2786
marcel-rbro wants to merge 2 commits into
masterfrom
docs/image-format-webp

Conversation

@marcel-rbro

Copy link
Copy Markdown
Contributor

The lint_images CI check requires WebP and rejects PNG, JPG, and other raster formats, but the style guide still told writers to use PNG for screenshots - so following the docs failed the build. This updates content-standards.md and quality-standards.md to say WebP and points to pnpm opt:images.

🤖 Generated with Claude Code

The lint_images CI check requires WebP and rejects PNG/JPG, but the style
guide still said PNG for screenshots. Update the standards to match.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the t-docs Issues owned by technical writing team. label Jul 20, 2026
@apify-service-account

apify-service-account commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit 0b7a6a0a) is ready at https://pr-2786.preview.docs.apify.com (see action run).

@marcel-rbro
marcel-rbro marked this pull request as ready for review July 20, 2026 09:52
Comment on lines +208 to +212
- **WebP** for screenshots and diagrams
- **SVG** for logos and icons (when available)

New raster images must be WebP. The `lint_images` CI check fails on PNG, JPG, and other raster formats. Convert and optimize an image - or a whole directory - with `pnpm opt:images <path>`, then update your Markdown to reference the resulting `.webp` file.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not entirely true isn't it? We are remaking Apify-related screenshots into SVGs so it's not only for logos or icons, and we wouldn't be changing it to WebP either.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants