Adding notebooks to docs

[prady0t]

What type of PR is this? (check all applicable)

• 💾 Refactor
• 🪄 Feature
• 🐞 Bug Fix
• 🔧 Optimization
• 📚 Documentation
• 🧪 Test
• 🛠️ Other

Related issues

• Closes Include notebooks in documentation #710

Checklist

• Code follows style guide
• Tests added
• Documented the changes

---

Please explain your changes below.

[prady0t]

@hameerabbasi, could you review this whenever free? I've added the "Notebooks" section in nav (and it's visible, but not on the home page with an icon just like other sections). Currently, there are also some failures in the Jupyter notebook itself.

[codspeed-hq]

CodSpeed Performance Report

Merging #894 will degrade performances by 44.45%

_{Comparing prady0t:notebooks (a2044dc) with main (3a2e703)}

Summary

❌ 1 regression
✅ 339 untouched

⚠️ Please fix the performance issues or acknowledge them on CodSpeed.

Benchmarks breakdown

	Benchmark	BASE	HEAD	Change
❌	test_index_slice[side=100-rank=2-format='gcxs']	1.8 ms	3.2 ms	-44.45%

[hameerabbasi]

It seems like matplotlib needs to be added to the docs dependencies.

[hameerabbasi]

Also please rebase on master.

[prady0t]

Maybe we can just not run the notebook in docs? These dependency errors are basically because mkdocs-jupyter runs the notebook in a fresh Jupyter Kernel (not in the current env). There could be a workaround for this but I don't think running them in docs is that necessesary. Especially when we can easily open them in Google Colab from the same page.

The better approach would be to have the standalone notebook files so they do not depend on the sparse envs. I've pushed the changes with execute disabled, let me know your thoughts.