I don't understand your argument. The vast majority of people reading any kind 
of tutorial like this are going to:

  * either read it in some form of rendered HTML
  * or download a Jupyter notebook and start from there (here however the focus 
is again much more on code than text in my experience { well, IME people are 
just lazy 95% of the time and use jupyter notebooks for everything and then 
share code that way, which ends up as a mess almost always } )



Almost no one reads as / starts working from some random file format, be it 
Org, Markdown, etc. For instance the number of times people have read and used 
the Org files of notes I sent people over the PDF is.... probably 0.

In the end then it doesn't make a difference whether the actual original 
document is written as source code for a language, in a text format with code 
snippets like Org etc.

You might be getting the wrong impression from the mini plotting example, 
because it's essentially only code and barely any words. But that's only 
because it's more of a placeholder and less of a proper getting started guide.

Reply via email to