## Why [Jupyter Notebooks](https://jupyter.org/) are key to Data Scientists and Machine Learning Engineers workflows, but [the file structure](https://nbformat.readthedocs.io/en/latest) is not really git friendly, and code review is impossible on GitLab. However, with some preprocessing on the ipynb file it is possible to reuse most of existing GitLab UI. ## How 1) Convert the ipynb to markdown that can be easily diffable, since it's just text. This conversion initially won't include execution order or html outputs. (https://gitlab.com/gitlab-org/incubation-engineering/mlops/ipynb2md) 2) Integrate the converter script with the diff flow 3) Iterate on improving the diff rendering ## Current state We explored how different tools (Gitlab, Github, ReviewNB) support MRs containing Jupyter Notebooks https://gitlab.com/gitlab-org/incubation-engineering/mlops/meta/-/issues/12 ### Links / references * Jupyter Notebook: https://jupyter.org/ * The Jupyter Notebook File Format: https://nbformat.readthedocs.io/en/latest * NBDime http://nbdime.readthedocs.io/en/stable/