jupyter / notebook

Jupyter Interactive Notebook
https://jupyter-notebook.readthedocs.io/
BSD 3-Clause "New" or "Revised" License
11.73k stars 4.97k forks source link

notebook won't render #5000

Open sickmint79 opened 5 years ago

sickmint79 commented 5 years ago

i don't understand why notebooks not rendering is such a consistent problem. i see many people mention the issue here. i've been adding notebooks into our private repo for months. they are not complicated. we've got an enterprise account. yet your very safe money is absolutely on betting the notebook is going to render at any given time.

instead of colleagues being able to see if code is useful, they have to download and open it themselves, maybe set up a test to even run the code so that they can see the results that are intended to be shown. alternatively i could upload .py scripts instead of python notebooks - but this seems like giving up on functionality that should simply work, and some of the notebooks do indeed create visualizations and are much more valuable in notebook format. yet i'm 0/6 on the ones i just tried to run.

this is beyond frustrating!

violetguos commented 4 years ago

Notebooks are not designed for version control, unfortunately.

jasongrout commented 4 years ago

i don't understand why notebooks not rendering is such a consistent problem.

It sounds like you are referring to notebooks rendering on GitHub. If so, please file an issue with GitHub. We do not have any control over notebooks rendering on GitHub.

Notebooks are not designed for version control, unfortunately.

This is a separate issue than GitHub rendering notebooks. Two interesting ways of having version control and notebooks are:

  1. Use nbdime to diff between notebooks. You can hook it into your vcs as well:https://nbdime.readthedocs.io/en/latest/vcs.html
  2. Use Jupytext to save notebooks in plain text instead of JSON, which works very well with version control: https://github.com/mwouts/jupytext