Attempt at integrating the tutorials in API

[thomasrobiglio]

No description provided.

[codecov]

Codecov Report

All modified lines are covered by tests ✅

Comparison is base (2962f82) 91.86% compared to head (5628709) 91.90%.
Report is 12 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #457      +/-   ##
==========================================
+ Coverage   91.86%   91.90%   +0.04%     
==========================================
  Files          60       60              
  Lines        4300     4375      +75     
==========================================
+ Hits         3950     4021      +71     
- Misses        350      354       +4     

see 6 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[maximelucas]

Nice work, thanks so much @thomasrobiglio !! Honestly I think it looks good.
We could start being picky with some of the spacing but I'd say let's do that only later when we change to the other documentation theme.

Minor things:

• the links to other tutorials link to the github notebooks, instead of the documentation tutorial.
• The names of the tutorials don't look consistent. That's coming from the titles inside the notebooks I think?

Finally I was just wondering how much of this is automatised/customisable? What's the workflow when we add new tutorials?

[thomasrobiglio]

TO DO:

• uniform titles 🆗
• fix links 🆗
• put different categories ("Getting started", "Focus tutorials" etc.) in different files and change appearance of toctrees
• add missing descriptions in recipes 🆗

Closing #463 #464 #451 as incorporated in this PR.

[thomasrobiglio]

I am updating the links, since I am 'guessing' them I might need to open another pr once the version of the readthedocs with the tutos is stable

[thomasrobiglio]

Ok, everything we discussed last week is done. I have also added a recipe for the multilayer draw (it is not shown anywhere else otherwise).

This is now ready for reviewing and merging.

[nwlandry]

Looks good @thomasrobiglio and ready to merge if @maximelucas agrees. The only small detail is to change the "-" to "." in the title of Recipe 12.

[maximelucas]

Looks great, thanks so much Thomas!!! This is a big step for our docs.