Oleg Isonen 981f45fd0d docs: Optimize documentation image sizes (#6253) ...

## Summary

Replace ten oversized PNG screenshots in the product documentation with
high-quality WebP assets and update their references.

The affected assets shrink from 27,813,051 bytes to 2,822,010 bytes (90%
smaller) while retaining their original pixel dimensions.

## Technical choices

- Encoded screenshots as WebP at quality 88 with sharp YUV conversion.
- Kept original dimensions to preserve UI text legibility and zoom
detail.
- Left animated GIFs unchanged: GIF-native optimization, palette
reduction, and resizing tests increased their file sizes, so changing
them would add cost or reduce clarity.
- Kept documentation content, navigation, and public page paths
unchanged.

## Checklist

1. [x] Audit raster assets in `docs/.gitbook/assets`.
2. [x] Optimize referenced PNG assets above 1 MB where conversion
materially reduces size.
3. [x] Update every affected documentation reference.
4. [x] Verify replacement dimensions and image decoding.
5. [x] Verify visual quality (SSIM 0.961–0.997 plus manual spot checks).
6. [x] Verify new references resolve and removed filenames are no longer
referenced.
7. [x] Review documentation impact; this PR changes documentation assets
and their direct references only.
8. [x] Verify no fixture inputs or generated fixture outputs are
affected.

## Verification

- `git diff --check`
- Reference checks for all ten added and removed filenames
- Pixel-dimension comparison for all ten replacements
- FFmpeg SSIM comparison for all ten replacements
- Manual visual review of representative full-resolution screenshots

The repository formatter excludes these documentation files, so it
reported no matching targets. Agent evaluations were not run because
this is a documentation-asset-only change.

Closes #6252

2026-08-27 17:39:10 +02:00

218 KiB

2798x1650px

Raw Permalink History