Book Notebook Parity

Use this skill when notebooks are part of the book's argument and need to be reviewed as seriously as the prose.

When to Use

• companion notebooks exist for chapters or units;
• the manuscript makes claims about notebook outputs;
• notebooks may be stale or simplified; and
• you need a keep / relabel / rewrite recommendation.

Procedure

1. Read the surrounding chapter before judging the notebook.
2. Check whether the notebook's title and framing match what it actually does.
3. Separate execution blockers from conceptual blockers.
4. Classify each notebook:
   • keep and validate;
   • relabel and repair; or
   • rewrite.
5. Recommend a repair order based on trust risk.

Review Questions

• Does the notebook implement the algorithm it claims to implement?
• Does the prose overpromise relative to the notebook?
• Is the notebook runnable in the current environment?