Feat: Add pre-commit hook that strips notebooks of metadata

[haroon0x]

Fixes #1372

Summary

This PR adds a pre-commit hook using nbstripout to automatically strip metadata from Jupyter notebooks before commits. This keeps diffs clean and readable by removing execution counts, cell outputs, and random cell IDs.

Changes Made

1. Pre-commit Configuration (.pre-commit-config.yaml)

• Added nbstripout hook (v0.8.1) from https://github.com/kynan/nbstripout
• Automatically strips metadata from all .ipynb files before commits

2. Documentation (docs/development.md)

• Added new "Pre-commit Hooks" section explaining:
  • How to install and set up pre-commit hooks
  • What each hook does (including nbstripout)

3. Cleaned Notebooks

• Stripped metadata from all 19 existing notebooks in the repository:

What nbstripout Does

The hook automatically removes:

• Execution counts: "execution_count": 1 → "execution_count": null
• Cell outputs: All printed results, plots, and output data
• Cell IDs: Random IDs like "GDUs0Q8gPYes" → Sequential "0", "1", "2"...

[rdyro]

Thanks!

Is there a way to do this without reformatting the notebooks? I think this PR reindents all notebook files.

Can you squash to a single commit please?

[haroon0x]

@rdyro I’ve removed the notebook formatting and squashed the commit.

[haroon0x]

@rdyro i don't see any other way to reformat the notebooks without including it any pr.

[rdyro]

Hmmm, I see this hook removes figures, we definitely want to keep those since they are part of the notebook examples when displayed in the docs.

Can we do this hook without removing cell outputs themselves (just metadata)?

[haroon0x]

@rdyro do you want me to include the reformatting of the notebooks in this pr ?

[rdyro]

I'm trying to review what this hook is actually suggesting. It's still trying to delete output images, I think?

[haroon0x]

In the git diff i see the images. what makes you think that the output images are still being removed ?

[rdyro]

I'm looking at the CI, it seems the hook still wants to remove the images before passing.

You're right that you're not modifying them now.

[rdyro]

Maybe I'm misreading this. That's a big diff it seems, but this PR is a good idea, so once the CI passes, I'll be happy to merge!

[haroon0x]

@rdyro ci is passing now.

[haroon0x]

@rdyro any changes ?