JacquesCarette
Wiki: New Workspace Setup
There are a few things that could be updated in New Workspace Setup.
- [ ] The introduction mentions WSL2 as the best way to use Drasil on Windows, but the actual Windows section only mentions Git Bash and Cygwin. It could be easy for someone to skip the introduction, so we might want to mention it in the Windows section too.
- While we're talking about it, do we even need to talk about Git Bash and Cygwin at this point? I never had issues with WSL2 and Drasil when I was using Windows, so it seems like the only method we need to talk about. If @samm82 or @jackwyand have opinions on this (I think you both use Windows?), feel free to let me know!
- [ ] The page recommends installing Haskell from Stack. I believe GHCup is the preferred option these days, as it installs not only Stack but several other helpful utilities.
- [ ] In the Stack install instructions, the Mac section has a debugging note for Linux users that doesn't show up in the Linux section.
- [ ] I think it would be helpful if, for each package, we make it more clear which users of Drasil need to install what. E.g. as a GOOL person I haven't had to install Graphviz.
I also have a comment on the level of detail in this page. For a lot of the packages we have very in-depth, platform-specific instructions. This can be quite helpful, but for many of the packages I'm guessing we're just summarizing what's on their own install pages. Would it not be more sustainable to simply link to those pages so that we don't have to worry about our instructions going out of date? We could simply point people to the official guides and mention any subtleties not mentioned there. I don't think it's worth undoing what we have as long as it is up-to-date, but as we add or update the instructions it would be worth keeping in mind.
Contributes to #4401.
I'm fine with moving to WSL2 as the primary method - but I still use Cygwin. I agree with the rest, and very much so about not summarizing package's install instructions.
Related: https://github.com/JacquesCarette/Drasil/issues/3728
Regarding Windows, I've found that WSL2 has a really heavy overhead with CS 1JC3. GHCup on a native windows installation seems to work fine for Haskell.
I wrote some instructions for CS 1JC3 that went pretty smoothly. You might be able to pull some information from it.
