Skip to content

Docs: align examples with SuperQuantX 0.3.0 APIs - #6

Merged
Superagentic-AI merged 1 commit into
mainfrom
docs-examples-0.3.0
Nov 5, 2026
Merged

Superagentic-AI merged 1 commit into
mainfrom
docs-examples-0.3.0

Conversation

@Superagentic-AI

Copy link
Copy Markdown
Contributor

Summary

  • Rewrote docs examples (and related API/backend pages) to match the real SuperQuantX 0.3.0 surface: portable add_gate / execute_circuit, simulator fluent API where it exists, QuantumNN instead of invented classifiers, FeatureMapSpec + build_feature_map_circuit, Ocean QUBO/Ising helpers.
  • Added scripts/check_docs_examples.py to extract and execute Python fences (shared namespace per page; <!-- docs-check: skip --> for credential-only hardware). Not wired into CI: full run is ~5 minutes with ML examples.
  • Removed or clearly marked APIs that are not available in 0.3.0 (for example VariationalQuantumClassifier, callable feature-map specs, OceanBackend.solve_tsp, broken benchmark_algorithm backend-name assumption).

Verification

  • python scripts/check_docs_examples.py: 267 blocks run, 0 failed, 21 skipped (plus 40 doc tests under pytest).
  • uv run mkdocs build --strict: passes.
  • Hardware snippets are API-checked and labelled as requiring credentials (skipped in the runner).

Notes

  • Do not merge until you have reviewed; left unmerged as requested.

Rewrite stale docs and README-adjacent examples to the real 0.3.0 surface
(add_gate/execute_circuit, QuantumNN, FeatureMapSpec, Ocean QUBO helpers).
Add scripts/check_docs_examples.py to extract and run Python fences; mark
credential-only hardware snippets with docs-check skip. mkdocs build --strict
passes; 267 blocks run with 0 failures (21 skipped).
@Superagentic-AI
Superagentic-AI merged commit 14ca97f into main Nov 5, 2026
9 checks passed
@Superagentic-AI
Superagentic-AI deleted the docs-examples-0.3.0 branch November 5, 2026 04:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant