Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Erroneous (or unclear) instructions for manual WSL install #1987

Open
pa-0 opened this issue Jul 16, 2024 · 0 comments
Open

Erroneous (or unclear) instructions for manual WSL install #1987

pa-0 opened this issue Jul 16, 2024 · 0 comments
Assignees

Comments

@pa-0
Copy link

pa-0 commented Jul 16, 2024

Documentation Issue

The page in Microsoft Learn titled "Install to Windows Server" appears as follows:

Extract and install a Linux distribution

Now that you've downloaded a Linux distribution, in order to extract its contents and manually install, follow these steps:

  1. Extract the <DistributionName>.appx package's contents, using PowerShell:
Rename-Item .\Ubuntu.appx .\Ubuntu.zip
Expand-Archive .\Ubuntu.zip .\Ubuntu

By this point, a user following along would have downloaded the appx distribution file, renamed it to a zip extension in PowerShell and extracted its contents to a folder of their choice -- no issue there; however, step two goes on to instruct:

  1. Once the distribution has been downloaded, navigate to the folder containing the download and run the following command in that directory, where app-name is the name of the Linux distribution .appx file.
Add-AppxPackage .\app_name.appx

Why would the user navigate to the folder containing the "downloaded .appx distribution" that they just renamed to ".zip" and extracted its contents to different folder in the previous step (1)?

Moreover, navigating to the folder holding the recently extracted contents of the appx-renamed-zip file, the user would see the following list of files:

image

Now, I may have missed something, but it seems to me that if this is supposed to be guidance on a manual install. Once the Expand-Archive command has run, the next step would be running .\ubuntu.exe...

I was going to create a PR to correct this myself, but I just wanted to be sure that I'm actually looking at an error here or if this is a personal airhead moment on my part.

Link to documentation page

https://learn.microsoft.com/en-us/windows/wsl/install-on-server#extract-and-install-a-linux-distribution

Suggested Improvements

Rewrite.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants