JuliaAcademy/JuliaTutorials

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

logankilpatrick opened this issue · 2 comments

logankilpatrick commented

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.

#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

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?

  • 👍1
KristofferC commented

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

Literate.jl is also a (good) choice.

  • 👍1