canonical / open-documentation-academy

Learn open-source software documentation skills with Canonical
https://canonical.com/documentation
Apache License 2.0
48 stars 28 forks source link

Ubuntu WSL: update and improve Install Ubuntu on WSL2 guide #85

Closed edibotopic closed 1 week ago

edibotopic commented 3 weeks ago

Update the following guide:

Install Ubuntu on WSL2

Background

This Ubuntu WSL guide explains multiple ways to install Ubuntu WSL on a Windows device.

There are some quick improvements that can be made to the guide:

You are welcome to highlight any other small issues that you observe and suggest changes.

Prerequisites

Access to a Windows machine and a familiarity with WSL would be helpful for understanding the content and testing any commands.

The specific issues outlined above can be addressed without significant experience of WSL or access to a Windows machine.

krzysiekwie commented 3 weeks ago

Happy to do it this week/weekend (actually need to switch to WSL instead of dual-booting :)

edibotopic commented 3 weeks ago

That's great @krzysiekwie !

The file for the current version of the guide can be found here:

Open Documentation Academy: Install Ubuntu on WSL2

This file is the one that you should work on. If submitting a PR outlining your changes please do so through the Open Documentation Academy repo. When any changes are eventually merged into the WSL repo I will credit you during that merge.

I will assign this to you now. Take your time and let me know if you have any questions.

Thank you.

krzysiekwie commented 2 weeks ago

@edibotopic The PR is a minimal edit to address your issue description. Feels like maybe the text was first planned to be a more complete/ less formal tutorial but got quickly published as a guide. Let me know if you think it should get expanded/revised further.

edibotopic commented 2 weeks ago

That's great @krzysiekwie . I appreciate the quick work on this. I think you might be right about the confusion between tutorial and guide also. I will have a look at what you submitted ASAP and get back to you with any comments. Thanks again!