Document WSL Installation

[sandyscott]

In reponse to an ask.sagemath question about package installation on windows, I linked to my documentation for a from-source installation on WSL.

Emmanuel Charpentier requested that I added this to the official documentation.

I've added a section on setting up WSL to en/installation/source.rst and a section which covers the steps needed to launch sage in WSL from the windows desktop or start menu to en/installation/launching.rst

CC: @tobiasdiez @EmmanuelCharpentier

Component: documentation

Keywords: WSL

Author: Sandy Scott

Branch/Commit: ec25daf

Reviewer: Tobias Diez

Issue created by migration from https://trac.sagemath.org/ticket/31138

[sandyscott]

Branch: u/gh-sandyscott/document_wsl_installation

[sandyscott]

Commit: bbe6b4d

[sandyscott]

Changed keywords from none to WSL

[tobiasdiez]

comment:4

Thanks for adding the documentation. The explanations are very good. Some small suggestions from my side:

• Did you tried it on WSL 2 with Ubunutu 20.04? Last time I tried, I run into serious problems, I think it was with ecl. On 20.10 it does work for me as well. Maybe this should be made more explicit in the explanation?
• You can restart the WSL instance more easily via wsl --shutdown.
• "I'd recommend" - I think the rest of the documentation is more in the "we" form, i.e. "we recommend" or "it is recommended".

[sandyscott]

comment:5

I've just done an install (of 9.2) on Ubuntu 20.04, it compiled successfully and passed all the tests. However, Jupyter won't start, and I can't install the package that motivated me to do the WSL from source install in the first place.

I'll make the upgrade to 20.10 an instruction rather than a recommendation.

Thanks for the other suggestions.

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

ec25daf

Made Ubuntu 20.10 mandatory for WSL installation, mentioned alternative WSL reboot methods, small typos.

[sagetrac-git]

Changed commit from bbe6b4d to ec25daf

[mkoeppe]

Author: Sandy Scott

[tobiasdiez]

comment:8

LGTM!

[tobiasdiez]

Reviewer: Tobias Diez

[vbraun]

Changed branch from u/gh-sandyscott/document_wsl_installation to ec25daf