[RFC] Update the state of OCaml on Windows about v2.ocaml.org HOT 3 OPEN

This is a thoroughly good idea, @patricoferris! It's definitely worth splitting the problem into "New user who wants to try OCaml and happens to be on Windows" vs "User who needs Windows binaries".

I don't know the technical details for the editor (it's not my workflow!), but it would be worth the complete beginner having something like:

• You need WSL2 (that's worth underscoring - WSL1 is harder and slower to use with opam), linking the standard instructions from Microsoft and recommending Ubuntu 20.04 as the distro to use
• This is the plumbing required to use VS Code + WSL2 installation of OCaml
• Note that you'll be producing Linux binaries, not native Windows programs (with a link to a separate page on native Windows)

I don't think it's wrong at this stage to state that running OCaml on native Windows is just not a beginner operation (but that we're working on it!)

from v2.ocaml.org.

I'm not sure about Docker, to be honest - it seems to be something that users are either very familiar with or utterly terrified by (from limited experience based on triaging opam issues for repro cases!). I would think it's definitely worth a mention, again with a link to a separate page - I think what's probably wanted is the keyword "Docker" somewhere for those that know, but with no risk that a beginner (both for OCaml and Docker) ends up in a container thoroughly confused!

from v2.ocaml.org.

Thanks @dra27 -- that sounds like a good compromise, especially catering towards the beginner use case on the up_and_running page. Do you think it is worth mentioning the docker images at all on this page ? It might add some confusion but I'm also aware that the images are not really promoted anywhere obvious at the moment (it might also help clear up the "should I be using ocaml/opam, ocaml/opam2, ocaml/ocaml or ocurrent/opam repository" problem 😁)

from v2.ocaml.org.