Fp-ts: Idea: documentation website

[stereobooster]

There is https://github.com/gcanti/fp-ts/tree/master/docs/api/md, but it would be nice to have this as a website

Example: https://funfix.org/api/core/classes/try.html

[jasonkuhrt]

Maybe we can generate the markdown files from source-code types and above-function documentation parsed with support for e.g. markdown.

@gcanti Could you scope out what an ideal solution for you would look like and what level of help you're willing to accept toward that end?

[gcanti]

@jasonkuhrt the md files are generated from the source (command npm run docs)

[jasonkuhrt]

Then we can add a layer on top like Gitbook. I don't think a whole bespoke website is _necessary_.

[unix]

try this repo?
generate html from md source.

[piq9117]

after we fill up the docs we can take the md files and feed it to a static site generator like hakyll

[grossbart]

@gcanti worked on generating better API documentation recently (https://github.com/gcanti/docs-ts), which inspired me to start writing docs: https://github.com/gcanti/fp-ts/pull/779

There's still a lot of work ahead, but I'm closing this issue now because we're getting there, slowly but surely 😄