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

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

Adds Pillow-based GIF animation scripts for three RX path concepts (header-data split, flow steering, and packet reorder), a shared incoming_wire.py module for wavy wire rendering, and the corresponding dark/light output images. The .gitignore is extended to cover __pycache__/.

• Three new standalone Python scripts generate multi-frame GIFs and poster PNGs for docs; wire drawing and arc-length path logic are factored into incoming_wire.py and reused across all three.
• hds_animation.py's rgba_frame_to_palette uses local variables named rgba and rgb, shadowing the module-level helpers of the same name — unlike flow_steering_animation.py and reorder_animation.py which use rgba_img/rgb_img.
• The squashed commit title (docs: add HDS, flow steering, and reorder packet animations) does not follow the required #<Issue Number> - <Title> format, and no GitHub issue is referenced in the PR description.

Confidence Score: 5/5

Docs-only change adding Python animation scripts and generated GIFs; no library code, API surface, or build system is touched.

All changed files are documentation assets and standalone image-generation scripts. The library source, CMake build, and public API are untouched, so there is no risk to runtime behaviour.

docs/images/packet_diagrams/hds_animation.py — minor naming inconsistency in rgba_frame_to_palette worth fixing for consistency with the other two animation files.

Important Files Changed

Filename	Overview
docs/images/packet_diagrams/incoming_wire.py	New shared module exporting wavy wire drawing, packet markers, and arc-length path helpers; clean and consistent with callers.
docs/images/packet_diagrams/flow_steering_animation.py	New flow-steering GIF generator; consistent helper naming (rgba_img/rgb_img) and correct dual-theme rendering loop.
docs/images/packet_diagrams/hds_animation.py	New HDS GIF generator; rgba_frame_to_palette uses local variables named rgba/rgb that shadow the module-level helper functions, inconsistent with the other two animation files.
docs/images/packet_diagrams/reorder_animation.py	New reorder GIF generator; commit title does not follow the required # - <Title> format.
.gitignore	Adds pycache/ entry; appropriate for newly added Python scripts.

_{Reviews (4): Last reviewed commit: "docs: add HDS, flow steering, and reorde..." | Re-trigger Greptile}