Revamp docs site on distributed process

[joelmccracken]

No description provided.

[tmcgilchrist]

Do you have a preference for what the new site uses or looks like? I've used GatsbyJS for these sort of sites before, which is not Haskell but works fine. You write the content in markdown files and you can include code sections into the markdown.

As part of this, it would be useful to have a corpus of examples for distributed-process that are kept up to date. I'm often writing small sample apps or copying the Haddock sample code into files to test it out. Keeping them alongside the distributed-process repo would convenient. Do you have a preference for this?

cc @LaurentRDC

[LaurentRDC]

There are many suitable static site generators.

I would suggest any static site generator that can use Pandoc. The reason is that Pandoc supports Literate Haskell as input, such that the body of a page can both be a valid Haskell module, AND a webpage. I use this myself (e.g. this blog post is a Literate Haskell file) in combination with hakyll, which a static site generator build with Haskell and used throughout the ecosystem.

I think the current site uses Jekyll, which is another popular choice that plays very well with Github pages.

Beyond this, whoever wants to put in the work gets to make the work as easy for them as they want!