Add fix mdoc supersede 277

[zakpatterson]

This includes prior commits from 227, and more or less finishes the work of migrating the readme to mdoc with a docusarus site.

To run, this should work:

sbt> docs/mdoc
sbt> docs/docusaurusCreateSite
$ cd website && yarn start

[fdietze]

Wow!

Thank you for working on this one. 👍

[zakpatterson]

It's by no means complete, I didn't try to scrape and fix the old website code, but i think it's an improvement over the giant readme, and hopefully we can improve the docs incrementally now that it's easier to do so.

[fdietze]

I commited some improvements. Unfortunately I'm not able to run docusaurus on NixOS. (It always tries to compile gifsicle, which I have already installed...)

By removing many :shared modifiers, I also encountered this bug: scalameta/mdoc#183

[zakpatterson]

Ah yes I ran into that exact error actually, and that's why I just put :shared on everything. Plus I think the default JVM behavior matches the :shared behavior. I wonder why :shared is used in JS but :reset is used in JVM.

[zakpatterson]

@fdietze should we put the shareds back or what do you think

[fdietze]

@fdietze should we put the shareds back or what do you think

I think :shared should only used as it was intended. For shared code, such as imports. With the new mdoc release it works without shared.

[fdietze]

why deleting yarn.lock? Probably a mistake...

[zakpatterson]

I don't think we have the need for yarn.lock in the same way js projects do. We don't care about reproducible resolutions of dependencies from npm. I get that's an opinion, but if we leave it then the entire file will change and innocent PRs could create 1000 line diffs, I just don't see the point of having it in this project.

[cornerman]

What is the state here? :)

[fdietze]

I finally took the time to finish and merge. Also thanks to @zakpatterson !