-
Notifications
You must be signed in to change notification settings - Fork 2.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add alt text to images #13555
base: main
Are you sure you want to change the base?
Add alt text to images #13555
Conversation
Pull Request Test Coverage Report for Build 12401585817Details
💛 - Coveralls |
…erra into BD-add-alt-text
One or more of the following people are relevant to this code:
|
Co-authored-by: Eric Arellano <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for this PR! I think it's a good start, but I wonder if we would like to eventually make it a bit more informative, because the descriptions are still very generic. I suggested a few minor changes on some descriptions (circuit diagram output instead of output), but overall LGTM. Reviewing this PR also gave me the chance to catch a few documentation bugs (#13635)!
@@ -130,6 +130,7 @@ | |||
convert it into a :class:`.QuantumCircuit`: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is a case of:
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -27,6 +27,7 @@ def multiplier_cumulative_h18( | |||
performs a non-modular multiplication on two 3-qubit sized registers is: | |||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -35,6 +35,7 @@ def multiplier_qft_r17( | |||
For example, on 3 state qubits, a full multiplier is given by: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -395,6 +398,7 @@ | |||
:meth:`.CouplingMap.build_coupling_map`: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Probably out of scope for this PR, but I don't see the output for these 3 snippets in https://docs.quantum.ibm.com/api/qiskit/transpiler#representing-quantum-computers
@@ -539,6 +544,7 @@ | |||
For example, to run a simple phase estimation circuit: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -970,6 +989,7 @@ | |||
we can then call :func:`~.transpile` on it with ``scheduling_method`` set: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -989,6 +1009,7 @@ | |||
also look at it with the :func:`.timeline.draw` function: | |||
|
|||
.. plot:: | |||
:alt: Diagram illustrating the previously described circuit. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't think any of the 3 generic descriptions really fit this one, what about?
:alt: Diagram illustrating the previously described circuit. | |
:alt: Output from circuit timeline drawer. |
@@ -455,6 +455,7 @@ class TranspileLayout: | |||
let the input circuit be: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -470,6 +471,7 @@ class TranspileLayout: | |||
Suppose that during the layout stage the transpiler reorders the qubits to be: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
@@ -498,6 +500,7 @@ class TranspileLayout: | |||
becomes: | |||
|
|||
.. plot:: | |||
:alt: Output from the previous code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
:alt: Output from the previous code. | |
:alt: Circuit diagram output by the previous code. |
We need to add alt text to images for accessibility.