Open
Description
🐛 Bug
There are a couple of documentation issues in the README.
To Reproduce
Steps to reproduce the behavior:
The README says
This repo in main branch contain only python scripts with markdown extensions, and notebooks are generated in special publication branch, so no raw notebooks are accepted as PR. On the other hand we highly recommend creating a notebooks and convert it script with jupytext as
jupytext --set-formats ipynb,py:percent my-notebook.ipynb
Expected behavior
- In "On the other hand we highly recommend creating a notebooks and convert it script with
jupytext
as", there are a couple of issues. It should be just "notebooks" instead of "a notebooks" and something like "convert it usingjupytext
". - The
jupytext
command also doesn't work because the command tries to read anipynb
file when we only provide Python scripts. Also I think for most users they don't need to sync the notebook and Python script and just need to convert from a script to a notebook. So it might be simpler to give a command likejupytext --output input.py output.ipynb