Skip to content

Update Grover's algorithm tutorial to new tutorial format#5069

Open
henryzou50 wants to merge 2 commits intomainfrom
grovers-algorithm-update
Open

Update Grover's algorithm tutorial to new tutorial format#5069
henryzou50 wants to merge 2 commits intomainfrom
grovers-algorithm-update

Conversation

@henryzou50
Copy link
Copy Markdown
Collaborator

@henryzou50 henryzou50 commented May 5, 2026

Summary

  • Restructure the Grover's algorithm tutorial to match the standard tutorial template: add Learning outcomes / Prerequisites sections, split execution into a local-simulator example (using StatevectorSampler) and a hardware example, and bump dependency versions (Qiskit SDK v2.0+, Qiskit Runtime v0.22+).
  • Add a new "Discussion: Two-qubit gate depth scaling" section that transpiles Grover circuits for 3–9 qubits and plots the resulting 2Q depth, motivating why Grover's is a fault-tolerant target rather than a near-term one.

Test plan

  • npm run check passes (markdown, spelling, internal links, orphan pages, qiskit-bot)
  • All updated/new output images load (c150298f-0, 283d5265-0, 4933ae44-0, a5ef9913-0, c4f67f35-0, be3c3d9e-0, abc6b43c-1)
  • Re-run the notebook end-to-end to confirm the simulator and hardware code blocks still execute cleanly on current Qiskit SDK v2.0+ / Runtime v0.22+

…d tutorial template used across the docs

- Add Learning outcomes and Prerequisites sections
- Update description metadata and dependency versions (Qiskit SDK
  v2.0+, Qiskit Runtime v0.22+)
- Split execution into a "Small-scale simulator example" section
  (using StatevectorSampler for local simulation) and a "Hardware
  example" section that bundles steps 1-4 into a single block
- Replace internal /docs links with absolute docs.quantum.ibm.com URLs
- Add a "Discussion: Two-qubit gate depth scaling" section with a
  plot illustrating why Grover's is a fault-tolerant target
- Add tutorial survey link and bump copyright to 2026
- Remove duplicate cells from previous revisions
- Add `{/* cspell:ignore fontsize */}` to allowlist matplotlib's
  fontsize keyword used in the new scaling plot
@henryzou50 henryzou50 requested a review from a team May 5, 2026 17:00
@review-notebook-app
Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@qiskit-bot
Copy link
Copy Markdown
Contributor

One or more of the following people are relevant to this code:

  • @blannix
  • @nathanearnestnoble

Survey link even before linked to a different tutorial
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

3 participants