[WIP] Initial LSTF Windows setup instructions update #861
Conversation
froggleston
changed the title
✅ Deploy Preview for workshop-template-previews ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
There was a problem hiding this comment.
Thanks @froggleston 🙌 Your descriptions and explanations are clear but my overall impression is that this is too long and might be intimidating for some novices. (Screenshots are necessary but are going to make it longer still.)
I wonder if we can use nested tabsets, e.g. to display the WSL instructions by default with a separate tab for Git for Windows? Or a lower-tech option might be some details elements to collapse some of the blocks down?
| Linux comes in many flavours, called <a href="https://en.wikipedia.org/wiki/Linux_distribution">“distributions”</a>, and each has its own benefits, features and quirks! | ||
| </p> | ||
|
|
||
| <p> | ||
| WSL 2 is a fully fledged Linux environment that runs completely within your Windows 10 or 11 operating system. | ||
| While there are many Linux distributions available to install (e.g. Ubuntu, Debian, Fedora, Mint, Arch, Gentoo, and hundreds more!), WSL 2 only supports a handful of distributions listed above due to the way it needs to be integrated with Windows itself. | ||
| </p> | ||
| <p> | ||
| So, we will use the default that WSL 2 recommends, Ubuntu. |
There was a problem hiding this comment.
| Linux comes in many flavours, called <a href="https://en.wikipedia.org/wiki/Linux_distribution">“distributions”</a>, and each has its own benefits, features and quirks! | |
| </p> | |
| <p> | |
| WSL 2 is a fully fledged Linux environment that runs completely within your Windows 10 or 11 operating system. | |
| While there are many Linux distributions available to install (e.g. Ubuntu, Debian, Fedora, Mint, Arch, Gentoo, and hundreds more!), WSL 2 only supports a handful of distributions listed above due to the way it needs to be integrated with Windows itself. | |
| </p> | |
| <p> | |
| So, we will use the default that WSL 2 recommends, Ubuntu. | |
| Linux comes in many flavours, called <a href="https://en.wikipedia.org/wiki/Linux_distribution">“distributions”</a>, and each has its own benefits, features and quirks! We will use the default that WSL 2 recommends, Ubuntu. |
There was a problem hiding this comment.
I've reduced the overall length of visible text and it's more digestible now I think. I added some details blocks to remove extra text that wasn't really required, but could help if people needed it.
| Install Ubuntu either via the <a href="#shell-windows-wsl-store">Microsoft Store</a>, or from within the <a href="#shell-windows-wsl-powershell">Windows Powershell</a> command prompt. | ||
| There are also <a href="https://learn.microsoft.com/en-gb/windows/wsl/install">full instructions</a> on the Microsoft website. |
There was a problem hiding this comment.
Can we pick one of these, in the interest of cutting down the length a bit?
There was a problem hiding this comment.
As discussed, I removed powershell instructions and kept the link to the full instructions on Microsoft's site if people were comfortable with that route.
| <p> | ||
| The first thing to do is to update the package manager's list of available packages. To do this in Ubuntu, we use a tool called <code>apt</code>. | ||
| Type the following command into the bash prompt: | ||
| <code>sudo apt update</code> | ||
| </p> | ||
| <p> | ||
| <strong>Note:</strong> You will be prompted to enter your password. This is the password you set when installing Ubuntu, and will not show up on the screen as you type it in. | ||
| This is a security feature of the terminal, and is normal behaviour. | ||
| </p> | ||
| <p> | ||
| Install updated versions of packages required across all our lessons, by typing: | ||
| <ul> | ||
| <li><code>sudo apt-get install git build-essential autotools python3 r-base</code></li> | ||
| </ul> | ||
| </p> |
There was a problem hiding this comment.
Would you expect apt update to take a long time to run here? I genuinely have no idea but if so, I think it's worth including a comment that this is expected.
There was a problem hiding this comment.
Hmm yes it might if the connection is slow. I'll add a note in.
This is a work in progress update to the Windows setup instructions to include WSL 2 for Windows 10 and 11 users.
Things left to do: