I would like to include some worked examples in a package (distinct from unit tests).
-
Where should they go? A subdirectory in
docs
(will that interfere withDocumenter.jl
?) or intests
? -
Is there a framework for running them within CI? For now, I just want to run each example on Travis in a fresh Julia process, and check that it completes without an error. Later on it would be nice to check the results.
-
Is there a way I can splice a file into documentation generated with
Documenter.jl
as Julia source code, ie between ```s?