Skip to content

docs: animate the handbook figures with WebP walkthroughs - #58

Merged
karlitschek merged 2 commits into
mainfrom
docs/animate-handbook-webp
Aug 20, 2026
Merged

docs: animate the handbook figures with WebP walkthroughs#58
karlitschek merged 2 commits into
mainfrom
docs/animate-handbook-webp

Conversation

@karlitschek

Copy link
Copy Markdown
Member

Follows #57. Replaces the static screenshots in the handbook figures that show something happening with short, looping, animated WebP clips — much lighter and crisper than GIF for the in-app handbook, which renders in a real browser.

Now animated (WebP):

  • My leave — the balance ring counting up
  • Requesting time off — filling in the form (leave type, dates, working-day estimate, live balance preview, coverage warning). In-app is now WebP; the README keeps the GIF from docs: animate the handbook figures (WebP walkthroughs + request-form GIF) #57 for GitHub autoplay.
  • For team leads — opening a request and switching Details → Coverage (the two side-by-side stills collapse into one clip)
  • Team page — paging the month timeline
  • Recording absences — the confidential Category dropdown opening
  • Managing absences — applying a type filter
  • Insights — the meter bars animating in

Left as crisp stills (a loop would add motion but no information): dashboard widget, availability settings, entitlement editor, statistics, who's-off, sick-leave.

Weight: ~10 MB of WebP for seven animated figures — roughly a third of the equivalent GIFs. Recorded on the dev instance with a neutralised backdrop and a tutorial cursor (Playwright → ffmpeg frames → img2webp). Stale PNG/GIF assets the handbook no longer references are deleted. All figures verified loading in-app.

🤖 Generated with Claude Code

…figures

Replaces the static screenshots in the figures that show something happening
with short, looping, animated WebP clips (much lighter and crisper than GIF in
the in-app handbook, which renders in a browser):

- My leave — the balance ring counting up
- Requesting — filling in the request form (now WebP in-app; the README keeps
  the GIF for GitHub autoplay)
- For team leads — opening a request and switching Details → Coverage (the two
  side-by-side stills collapse into one clip)
- Team page — paging the month timeline
- Recording absences — the confidential category dropdown opening
- Managing absences — applying a type filter
- Insights — the meter bars animating in

The genuinely static figures (dashboard widget, settings, entitlement editor,
statistics, who's-off, sick-leave) stay as crisp stills. Total handbook imagery
is ~10 MB of WebP — far less than the equivalent GIFs. Stale PNG/GIF assets the
handbook no longer references are removed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@nextcloud-command nextcloud-command added the AI assisted This PR contains AI-assisted commits label Aug 20, 2026
…loading skeleton

The first take captured the loading skeleton and empty space (it started
recording before the data arrived), which read as broken. Re-recorded as a
smooth scroll down the loaded page — tiles → approval health → Bradford →
utilisation → liability — so every section is shown with real data.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@karlitschek
karlitschek merged commit db0e7cf into main Aug 20, 2026
21 of 31 checks passed
@karlitschek
karlitschek deleted the docs/animate-handbook-webp branch August 20, 2026 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AI assisted This PR contains AI-assisted commits

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants