documentation
documentation copied to clipboard
Tutorial housekeeping
There are some small differences between all the existing tutorials that we should clean up.
All the tutorials currently on learning:
- should use the same wording for each pattern step heading
- should include a list of requirements at the start
- should not include the author names at the top (there are some tutorials that were created from events that include the names)
This issue applies to both open and network tutorials
### Tasks
- [ ] https://github.com/Qiskit/documentation/pull/1379
Related issue: #1189
I wasnt able to find a single tutorial that does everything we want, but here are a couple that have good stuff:
- For consistent subheading naming checkout this one: https://learning.quantum.ibm.com/tutorial/quantum-approximate-optimization-algorithm
- for the requirements bullet list this PR: https://github.com/Qiskit/documentation/pull/1195/files
The tutorials that should be reviewed as part of this PR:
- [x] - https://learning.quantum.ibm.com/tutorial/variational-quantum-eigensolver
- [ ] - https://learning.quantum.ibm.com/tutorial/quantum-approximate-optimization-algorithm
- [x] - https://learning.quantum.ibm.com/tutorial/chsh-inequality
- [ ] - https://learning.quantum.ibm.com/tutorial/max-cut
- [ ] - https://learning.quantum.ibm.com/tutorial/heisenberg-chain
- [x] - https://learning.quantum.ibm.com/tutorial/grovers-algorithm
- [ ] - https://learning.quantum.ibm.com/tutorial/quantum-kernel-training
- [ ] - https://learning.quantum.ibm.com/tutorial/submit-transpiled-circuits
- [x] - https://learning.quantum.ibm.com/tutorial/repeat-until-success
- [x] - https://learning.quantum.ibm.com/tutorial/build-repetition-codes
another thing that would be good to add to each tutorial (but not sure how feasible it is) is an estimate of how much QPU time it takes. e.g. could this tutorial be run within the 10min open plan, or is it many hours so recommended to use serverless
example notice: QPU time estimate: ~X QPU minutes on Y backend (NOTE: this is an estimate only, your runtimes may vary)
@beckykd pointed out that the tutorials have a little clock icon and a time listed, which is the estimated time it takes to read that tutorial. When we start listing the QPU time too, it has the potential to be confusing, especially since the time-to-read is not labeled (only with the icon, and there's no hover text).
@javabster do we want both times listed on every tutorial? If so, we might want to get design help to make it clearer what the clock icon time means, so as not to confuse with the QPU time that we list in the tutorial itself.
@abbycross noticed that we have a couple of tutorials that start with a small example, then "beef it up" to be utility-scale (or closer). Would that be a good pattern to follow everywhere? It might make open users able to run more of the tutorials.
@abbycross and I landed on this text:
QPU time estimate: x minutes, y seconds on ibm_xyz. (NOTE: This is an estimate only. Your runtime may vary.)
- For consistent subheading naming checkout this one
Some notes on this text:
- There should not be periods in headings.
- "Primitives" in "Qiskit primitives" should be lower case.
@abbycross and I landed on this text:
QPU time estimate: x minutes, y seconds on ibm_xyz. (NOTE: This is an estimate only. Your runtime may vary.)
Raul said that "Usage" would be a more accurate term than "QPU".