set up a documentation site

[johnynek]

have a doc site that publishes and looks similar to the cats documentation (logos etc...)

[Slakah]

I'm a big fan of docusaurus, as I do personally find the end result to be more navigable (new word for me!), due to the prevalence of docusaurus documentation sites. I remember @RaasAhsan mentioning that the aim is for cats-effect to use docusaurus for the v3 docs, which appears to be corroborated by this commit typelevel/cats-effect@a2f1d19 .

Coursier has some scripts to handle setting up versioned docs, which we could lift, see: https://github.com/coursier/coursier/blob/master/scripts/shared/Docusaurus.sc .

I don't know how this stuff would fit into sbt-github-actions (due to unfamiliarity), but it doesn't seem insurmountable.

Edit: unless someone yells, I'll start looking at this stuff this week (no promises though :P).

[johnynek]

Thanks! That's great.

I'm not too opinionated. I did paradox in a project recently just I have only JVM dependencies.