docs(notebooks): add qubit-mapping guide

[haimeng-zhang]

Add qubit-mapping how-to guide to introduce the routing and layout transpiler stages.

Details and comments

Need dependence on package mapomatic

[pedrorrivero]

Thanks @haimeng-zhang!

Would you mind creating a notebooks directory inside of docs and placing yours inside? (i.e. ./docs/notebooks/<NOTEBOOK>)

[pedrorrivero]

Hi @haimeng-zhang can you check that this notebook runs with a freshly created environment and only this repo installed from source? Please make sure to install the notebook optional dependencies.

Since Friday, this should be equivalent to Qiskit 1.0.0. You will need to rebase this branch to main, let me know if you need help.

If you need additional dependencies please flag.

[coveralls]

Pull Request Test Coverage Report for Build 8940873145

Warning: This coverage report may be inaccurate.

This pull request's base commit is no longer the HEAD commit of its target branch. This means it includes changes from outside the original pull request, including, potentially, unrelated coverage changes.

• For more information on this, see Tracking coverage changes with pull request builds.
• To avoid this issue with future PRs, see these Recommended CI Configurations.
• For a quick fix, rebase this PR at GitHub. Your next report should be accurate.

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 100.0%

---

Totals
Change from base Build 8708380490:	0.0%
Covered Lines:	290
Relevant Lines:	290

---

💛 - Coveralls

[pedrorrivero]

@haimeng-zhang can we remove the word "guide" from the filename?

@ashsaki please have this review by end of day tomorrow so that Haimeng has time to integrate your suggestions and we can merge on Friday.

[itoko]

@haimeng-zhang @pedrorrivero I'd like to use this notebook in a lecture at a university this June, so I'm happy if this PR is merged by the end of May.