"Makefile" like capability for Literate examples? about literate.jl HOT 4 OPEN

Are you aware of Documenters draft mode? draft = true to makedocs(...).

from literate.jl.

Yes, I sometimes use that and expandfirst when I am debugging locally. But then when it is ready I push to github (without those debugging flags) and make a PR and the github actions build and rerun all the demos, most of which have not changed, wasting CPU time in the cloud. Which is why I was asking if there was a way to set up the Documenter.yaml or make.jl or such to be smarter about it in the cloud.

There is one brute-force option I've considered, which is to put every demo in its own repo, because then only one demo at a time would get built by github actions. That would be a maintenance pain though...

Another option might be to have one repo with a separate "subpackage" for each demo, each with its own docs/ and make.jl or such. I haven't found any examples of this approach though so not sure how to put it all together. Have you seen any examples of a single repo with multiple subpackages in it with partially separate Lit/Doc builds?

(Note to self, I might run into this issue: JuliaDocs/Documenter.jl#319)

from literate.jl.

So the expensive running of the examples are done with Literate, since you pass execute=true generally, right? You could probably invent something where you cache the .md files produced by Literate with GitHub artifacts. But you'd have to add the necessary logic into make.jl and your GitHub workflows.

from literate.jl.

Cool idea - thanks for the tip! I will look into that.
And yes, it is the Literate execute that takes the bulk of the time.

from literate.jl.