I’d like to create a directory of extended examples to go with a Haskell library I’m working on. This would live in an
examples directory alongside the
src directory for the package.
As well as Haskell code examples I’d like to be able to include the output of Haskell code fragments (probably controlled via a Makefile). I’d also like to include images generated by the library code and a small amount of mathematical notation.
I realize this is asking a lot and I’ve been looking at Haddock, Markdown dialects, Literate Haskell files and org files.
Has anybody done these kind of extended examples and could share your approach?