Quantum types tutorial

[Alexandre-Classiq]

PR Description

Including a new tutorial on quantum types and variables.

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[github-actions]

🔥 New notebook just dropped!

@amir-naveh , @TomerGoldfriend — come check out this shiny new addition to our repo.

[drorsegman]

My high level comments:

1. The exercises seem really good and helpful.
2. We should more strictly stick to the model of: Tutorial is solely exercises (with links to user guide, hints and solutions).
3. The diagrams you used to describe visually the different types look very helpful for users' understanding. I would keep them but not in the tutorial but in the user guide (and just make sure to add here links).

Do you think "workshop" is a more appropriate name to the exercises-only thing that I suggest here?

Also, I'm not sure we have to have identical structure for the user guide and workshop. I mean - maybe for explanation it is useful to have types separate from functions, but for hands on exercise it is more useful to mix them together (and just include good links to user guide).

Not sure about that, just pointing out the idea.

So, I'd say lets be more strict about the role of each documentation part (formal reference / user guide / workshop / docstring) but less strict about the unufied structure (let each part be structured in the most useful way for its purpose)

Reply via ReviewNB

[drorsegman]

This content is to be covered in the user guide, and only be linked from the tutorial.

Reply via ReviewNB

[drorsegman]

Here also, these are good explainations, but they should be left in the user guide. here e only want excercises + hints and solutions

Reply via ReviewNB

[drorsegman]

A general comment for smoother review: Let's try to keep each content paragraph in its own notebook cell, so that when I add a comment it is clear to which text it refers.

Learning checklist - Like.

Reply via ReviewNB