search

JuliaAcademy / JuliaTutorials

Learn Julia via interactive tutorials!
https://julialang.org/learning/
MIT License
1.26k stars 657 forks source link

Discussion on ".jl" -> Notebook vs Notebook -> ".jl" #60

Open logankilpatrick opened 4 years ago

logankilpatrick commented 4 years ago

Hey @NHDaly , I wanted to re-start the discussion on the workflow for generating Notebooks and ".jl" files.

I am trying to get the JuliaAcademy resources all set up in their new repos.

https://github.com/JuliaComputing/JuliaBoxTutorials/pull/57

In my opinion, it seems easier to use ".jl" files to create notebooks rather than the other way around. I am open to hearing your thoughts!

NHDaly commented 4 years ago

Hmm, yeah that makes sense! I can definitely see the appeal there. Using, what, something like Weave.jl to make the notebooks? That does sound like a good option.

I don't really have strong opinions either way. I guess I'd say to just prefer whatever the developers are already comfortable with? But yes, it would definitely make it easier to edit and review changes to these repos. Though some people might prefer to edit their tutorials directly as notebooks, so i'm not sure i'd want to force everyone to do one thing or the other?

KristofferC commented 4 years ago

Using, what, something like Weave.jl to make the notebooks?

Literate.jl is also a (good) choice.