Qiskit / qiskit / 9115614912

90%

main: 88%

Build Type

push

github

Committed by web-flow

Commit Message

Write complete manual `QuantumCircuit` documentation (#12403) (#12420)

* Write complete manual `QuantumCircuit` documentation

This writes huge tracts of new `QuantumCircuit` API documentation,
linking together alike methods and writing explanatory text for how all
the components fit together.  There's likely an awful lot more that
could go into this too, but this hopefully should impose a lot more
order on the huge `QuantumCircuit` documentation page, and provide a lot
more explanation for how the class works holistically.

In particular, the section on the control-flow builder interface could
do with a lot more exposition and examples right now.

* Reword from review

Co-authored-by: Matthew Treinish <mtreinish@kortar.org>

* Add missing text around `Var` methods

* Add example to `find_bit`

* Comment on metadata through serialization

* Add see-also sections to undesirable methods

* Re-add internal utilities to documentation

* Add examples to `depth`

---------

Co-authored-by: Matthew Treinish <mtreinish@kortar.org>
(cherry picked from commit 72ad545a8)

Co-authored-by: Jake Lishman <jake.lishman@ibm.com>

Run Details

7 of 7 new or added lines in 1 file covered. (100.0%)

7 existing lines in 2 files now uncovered.

62255 of 69467 relevant lines covered (89.62%)

230262.0 hits per line