⚠️ Unfortunately we can't accept new pages to the textbook. If you have something you want to share with the community, we highly recommend you self-publish. If you need help with self-publishing, or want feedback on your work, contact Frank Harkins on the Qiskit Slack workspace.
This is the repository for the Qiskit Textbook's content. This page is for people that want to report issues, or contribute to the Textbook, if you just want to read about quantum computing, go to the textbook webpage.
If you've found a problem in the textbook, please make a new issue.
OSX/Linux users can quickly set up by running
./install.sh
source .venv/bin/activatethen
python -m jupyter notebookWindows users should use Git Bash and Python version > 3.8 and < 3.11.
bash install.sh
source .venv/Scripts/activatethen
python -m jupyter notebookFor a more detailed guide, please check out the contributing document.
We're constantly updating and improving the textbook, but some users find changes disruptive. For this reason, we release the Textbook content in versions, which are snapshots of the content that cannot change.
The version number tells you what kind of changes have been made from the previous version. This repo follows a kind of semantic versioning, adapted to make more sense for non-code repos.
For a verision number MAJOR.MINOR.PATCH, we will increment the:
MAJORversion when changes remove or replace content,MINORversion for changes that add content, or that do not significantly alter the structure of existing pages. Examples include- adding new pages,
- rewording paragraphs for clarity, and
- small changes to code to make it work with newer Qiskit versions.
PATCHversion increments are for 'bugfixes' only. Examples include fixing- typos,
- statements that are incorrect, and
- code that does not work correctly with the version of Qiskit advertised on the page.
For example, if you're teaching using v1.0.3, you know you can switch to any
v1.0.x version without sections disappearing or code breaking with your
existing setup.