DOC: Delete cookbooks directory and fix cross-references - PR #3#1580
Merged
varunj-msft merged 1 commit intomicrosoft:mainfrom Apr 8, 2026
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Completes User Story #7933 (Migrate Cookbooks to Scenarios). This is PR 3 of 3.
All cookbook content was migrated in PR #1 (#1558) and PR #2 (#1564). This PR deletes the now-redundant doc/cookbooks/ directory and fixes all cross-references that pointed to it.
Deleted:
doc/cookbooks/ - all 11 files (5 .py, 5 .ipynb, README.md)
tests/integration/test_notebooks_cookbooks.py - test runner for deleted notebooks
Cross-references updated:
doc/myst.yml - removed cookbooks TOC section and site nav entry
doc/getting_started/README.md - removed cookbooks link (Scenarios link already exists)
doc/code/setup/1_configuration.py + .ipynb - cookbook links → 9_baseline_only.ipynb
doc/blog/2025_02_11.md - cookbook link → 9_baseline_only.ipynb
doc/generate_docs/pct_to_ipynb.py - removed "cookbooks" from included_dirs
Tests and Documentation
Full repo search confirms zero remaining cookbooks/ cross-references in source files.
ruff check passes on all modified .py files.
myst.yml validates as clean YAML with no orphan TOC entries.
All migrated replacement notebooks still pass integration tests (9_baseline_only, 5_simulated_conversation, 2_bias_benchmark).
No JupyText regeneration needed - this PR only deletes files and updates text references.