docs: add multi-turn strategy option to Qiskit code validation example

[vabarbosa]

Misc PR

Type of PR

• Bug Fix
• New Feature
• Documentation
• Other

Description

• Link to Issue: Fixes Add MultiTurnStrategy support to Qiskit code validation example #716

Implements configurable strategy selection for the Qiskit code validation example, allowing users to choose between RepairTemplateStrategy and MultiTurnStrategy for the Instruct-Validate-Repair (IVR) pattern. Includes updates to the README accordingly.

Changes

1. Code (docs/examples/instruct_validate_repair/qiskit_code_validation/qiskit_code_validation.py)

   • Added MultiTurnStrategy support alongside existing RepairTemplateStrategy
   • Implemented configurable strategy selection via use_multiturn_strategy flag
   • Added automatic context selection (ChatContext for MultiTurn, SimpleContext for RepairTemplate)
   • Updated function signature to accept strategy parameter
   • Updated docstring parameter documentation

2. Documentation (README.md)
   Added "Sampling Strategies" section explaining both strategies
   Added "Strategy Performance Comparison" section
   Updated Future Work section

Related Issues

• docs: add Qiskit code validation IVR example #576 (comment)
• MultiTurnStrategy doesn't include validation failure reasons in repair messages #631

Testing

• Tests added to the respective file if code was changed
• New code has 100% coverage if code as added
• Ensure existing tests and github automation passes (a maintainer will kick off the github automation when the rest of the PR is populated)

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|release)(?:\(.+\))?:

[github-actions]

The PR description has been updated. Please fill out the template for your PR to be reviewed.

[psschwei]

LGTM
@ajbozarth for final review

[ajbozarth]

Looks good on first glance, I'll take a deeper look after my morning calls to make sure it works locally for me.

[ajbozarth]

Actually given that I'm going to be working on top of this lets just merge this and if I find any bugs after rebasing my active work on top of it I'll include it in my upcoming PR.