Similarly to how it is done in geopandas, it would be nice to turn the notebooks into part of the pypsa-earth documentation.
Example: https://geopandas.org/en/stable/gallery/spatial_joins.html
It is also interesting to notice that they can also be executed online with binder:
https://mybinder.org/v2/gh/geopandas/geopandas/main?urlpath=lab/tree/doc/source/gallery/spatial_joins.ipynb