Jupyter Notebook ecosystem docs improvements

[ericsnekbytes]

This is part of a Jupyter-wide effort to better explain the Jupyter ecosystem to the community, by improving documentation for the Jupyter Project and its individual subprojects, and interlinking them.

[github-actions]

👈 Launch a Binder on branch ericsnekbytes/notebook/docs_notebook_ecosystem

[andrii-i]

Thank you for working on this @ericsnekbytes. Please find some comments and suggestions below.

[ericsnekbytes]

@krassowski Can you approve/merge this?

[echarles]

LGTM

[echarles]

Build / tests_check (pull_request) Failing after 2s is tagged as Required but is failing. Is it ok to merge?

[ericsnekbytes]

@krassowski @jtpio Does anyone know why check_links is failing because ModuleNotFoundError: No module named 'typing_extensions'? This seems like a flaky test...

[jtpio]

I restarted the check to make sure.

[ericsnekbytes]

I restarted the check to make sure.

Thank you!

[jtpio]

Another way to double check would be to open a draft PR with a dummy change and see of the check also fails there.

[echarles]

I restarted the check to make sure.

I had also restarted and it failed with the same error. I don't think it is related to this PR, but the job is marked as Required, so worth to fix it.

[jtpio]

Yeah if anyone can look into fixing it that would be great, thanks.

[ericsnekbytes]

@blink1073 Any insight here? I'm just trying to merge simple this simple markdown update PR, and the CI is preventing that :(

[krassowski]

Well that's clearly an upstream issue due to a faulty release of cattrs four hours ago, there is an issue open already: python-attrs/cattrs#369

[henryiii]

A quick fix would be either restricting 23.1.0 exactly or adding the transitive dependency, like in scikit-build/scikit-build-core@4b6dcfb.

[henryiii]

Fixed version released and old one was yanked. So should be fine now.

[jtpio]

Thanks @henryiii!

[jtpio]

@ericsnekbytes so re-running the check gives the following error which looks related:

[henryiii]

This is incorrect, I think.

[ericsnekbytes]

I'm testing an updated link now.

[ericsnekbytes]

@jtpio @krassowski @henryiii Checks have passed now, can someone merge this?