Skip to content

docs: expand quick-update cookbook + add config flag defaults#67

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/quick-update-docs-followup
May 28, 2026
Merged

docs: expand quick-update cookbook + add config flag defaults#67
Jammy2211 merged 1 commit into
mainfrom
feature/quick-update-docs-followup

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Summary

Completes items 3 and 4 of PyAutoPrompt/issued/on_the_fly_docs.md. Expands the analysis cookbook to fully document the on-the-fly quick-update machinery — both library flags (background_quick_update, live_visual_update), the Analysis API surface (perform_quick_update, supports_background_update, supports_jax_visualization), the Fitness.manage_quick_update dispatcher, and a custom-override example. Mirrors the two library config defaults into config/general.yaml.

Scripts Changed

  • scripts/cookbooks/analysis.py — rewrote the __Live Quick-Update Visualization__ section: documents live_visual_update separately from background_quick_update (the two are independent), adds an Analysis API surface subsection (perform_quick_update, supports_background_update, supports_jax_visualization), mentions Fitness.manage_quick_update, updates the commented API-shape example to show both flags, and adds a commented perform_quick_update override example. Tightens the Jupyter / script display surface description to name IPython.display.update_display with a stable display_id (the actual shipped mechanism) and the matplotlib viewer subprocess for script mode.
  • config/general.yaml — appends quick_update_background: false and live_visual_update: false under both updates: and hpc: with explanatory comments.

Test Plan

  • Smoke tests pass
  • python scripts/cookbooks/analysis.py runs under PYAUTO_TEST_MODE=1
  • Regenerated notebook for cookbooks/analysis.py renders the new section cleanly

Refs #66.

🤖 Generated with Claude Code

Rewrites the __Live Quick-Update Visualization__ section in the analysis
cookbook to document live_visual_update alongside background_quick_update,
adds an Analysis API surface subsection covering perform_quick_update,
supports_background_update, and supports_jax_visualization, mentions the
Fitness.manage_quick_update dispatcher, and adds a custom-override example.

Mirrors the two library defaults into config/general.yaml under updates:
and hpc: so workspace configs do not shadow them as unset.

Refs #66.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jammy2211 Jammy2211 added the pending-release PR queued for the next release build label May 28, 2026
@Jammy2211 Jammy2211 merged commit 56ced23 into main May 28, 2026
2 of 6 checks passed
@Jammy2211 Jammy2211 deleted the feature/quick-update-docs-followup branch May 28, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pending-release PR queued for the next release build

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant