I’ve been thinking about this lately too, and I keep getting niggling thoughts about “wouldn’t start from here if I were you” where “here” is all the accumulated tutorials to date for getting started with Jupyter notebooks… (which isn’t to say they aren’t good / useful, but maybe things are moving on…).
For example, if you run Jupytext, then src files can be markdown or python flavoured (other formats are also available). The formats omit the output cell content, but they are more readable and they can be dualled with ipynb files (I haven’t checked to see if the .ipynb files can be stored in a hidden directory path and the md/py files retained at the top level).
There are also new notebook fronted environments appearing everyday, many of them with preinstalled extensions/customisations/styling etc. I can’t keep up with all of them, but I wonder: have any of those environments started employing a workflow where py/md based files are the pseudo-first class document type, using Jupytext dualling, and ipynb docs (with output state) are handled discreetly via hidden directories, etc?