search

asdf-vm / asdf

Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more
https://asdf-vm.com/
MIT License
22.04k stars 784 forks source link

Document supported operating systems. #1687

Open electrovir opened 11 months ago

electrovir commented 11 months ago

How can we improve the documentation?

I've searched both the documentation website and GitHub issues and I see no clear documentation as to what operating systems are supported.

I'm guessing that, based on the table on the Getting Started page and relevant GitHub issues that I have found, that Windows is totally not supported but WSL2 is mostly supported, but I'm still unsure of any of that because it's not explicitly stated anywhere.

hyperupcall commented 11 months ago

You're right, that part could be documented better. The most information is at #1687 and #450. Windows is not supported directly, and neither it is via Cygwin or MSYS2. asdf should Just Work with WSL2 - the tests mostly pass, but we don't officially support it since that would require adding the platform to CI somehow (for something to be officially supported, it must be tested in CI)

hyperupcall commented 11 months ago

As for other UNIX-like systems, we only support Linux. There has been requests for FreeBSD (see #1605), but that requires extra work that has not been done yet