Add docs API diagrams and site updates

[chloecrozier]

Summary

• Add Pillow GIF animations for HDS, flow steering, and packet reorder
• Share RX wire rendering via incoming_wire.py (wavy lines, labeled in-flight packets)
• Broader docs/site work on this branch: API reference reorg, benchmarks, tutorials, metrics, and examples
• Made sure to create both light/dark versions

Examples

HDS

Flow Steering

Packet Reordering

Packet Reordering (Quantized)

Test plan

• Open GIFs under docs/images/packet_diagrams/{hds,flow_steering,reorder}/
• Regenerate: python3 docs/images/packet_diagrams/*_animation.py
• mkdocs serve and spot-check docs pages

[greptile-apps]

Greptile Summary

This PR adds animated WebP diagrams for three DAQIRI concepts (header-data split, flow steering, and packet reorder) alongside a shared RX wire renderer and a Makefile-driven reproducibility check. No C++ library code is touched — all changes are Python generation scripts, generated image assets, and a minor mkdocs.yml exclusion.

• New anim_common.py and incoming_wire.py modules share font loading, WebP export, and wire rendering across the three animation scripts.
• hds_animation.py, flow_steering_animation.py, and reorder_animation.py each produce dark and light WebP animations plus PNG poster frames into their own output directories.
• docs/images/packet_diagrams/Makefile adds make all and make check targets; the check target uses git status --porcelain to verify outputs are reproducible before committing.

Confidence Score: 5/5

Safe to merge — changes are entirely documentation tooling with no impact on the library build or runtime behaviour.

All changes are Python scripts and generated image assets used only for docs. The core C++ library, build system, and public API are untouched. The animation code is well-structured and the Makefile reproducibility check is a nice safeguard against stale committed assets.

No files require special attention from a correctness standpoint.

Important Files Changed

Filename	Overview
docs/images/packet_diagrams/anim_common.py	New shared utility module providing font loading with multi-platform fallbacks, a unified font scheme, and atomic animated WebP export via a temp-file rename pattern.
docs/images/packet_diagrams/incoming_wire.py	New shared RX wire rendering module; draws three parallel wire traces and optional in-flight packet markers. Wave animation is implemented but disabled by default (wave=False) in all current callers.
docs/images/packet_diagrams/flow_steering_animation.py	New animated WebP generator for flow steering concept; draws packets routed from NIC to per-flow GPU queues or the kernel fallback path across multiple themes.
docs/images/packet_diagrams/hds_animation.py	New animated WebP generator for header-data split; renders split header/payload paths to host and GPU memory with Bezier and rectangular path interpolation.
docs/images/packet_diagrams/Makefile	New build target wiring up the three animation generators plus a reproducibility check via git-status diff of generated directories.
mkdocs.yml	Excludes docs/images/packet_diagrams/README.md from the docs site build so the developer-facing regeneration instructions don't appear as a public page.
.gitignore	Adds a duplicate pycache/ entry; the pattern already exists on line 12 of the file.
docs/images/packet_diagrams/README.md	New developer README documenting requirements (Pillow 11.1.x with webp_anim), regeneration commands, and notes on WebP frame coalescing behavior.

_{Reviews (6): Last reviewed commit: "#159 - Replace packet-diagram GIFs with ..." | Re-trigger Greptile}