Bug 1902338 - Add docs for building Firefox on Windows with WSL. r=glandium DONTBUILD

Differential Revision: https://phabricator.services.mozilla.com/D213604

docs/setup/index.rst

@@ -15,6 +15,7 @@ Don't hesitate to look at the :ref:`Firefox Contributors Quick Reference <Firefo
    :maxdepth: 1
 
    windows_build
+   windows_wsl_build
    macos_build
    linux_build
    linux_32bit_build_on_64bit_OS

docs/setup/linux_build.rst

@@ -36,7 +36,7 @@ Python development files as well to install some pip packages.
 
 You should be able to install Python using your system package manager:
 
--  For Debian-based Linux (such as Ubuntu): ``sudo apt-get install curl python3 python3-pip``
+-  For Debian-based Linux (such as Ubuntu): ``sudo apt update && sudo apt install curl python3 python3-pip``
 -  For Fedora Linux: ``sudo dnf install python3 python3-pip``
 
 If you need a version of Python that your package manager doesn't have (e.g.:

docs/setup/windows_wsl_build.rst

@@ -0,0 +1,27 @@
+Building Firefox on Windows using WSL
+=======================================
+
+These steps were verified to work as of June 2024.
+
+#. Install WSL (Windows Subsystem for Linux) on Windows by running Windows Powershell as Administrator and typing:
+
+   .. code::
+
+      wsl --install
+
+#. Reboot Windows
+
+#. Upon reboot, you should be asked to set up a user and password for Linux. If not, open Ubuntu from the Start menu.
+
+#. Follow the :ref:`Building Firefox On Linux` instructions.
+
+   .. note::
+
+      For Mercurial to work, you will need to follow the instructions for bash and restart WSL.
+
+#. Run the following commands to install dependencies needed to build and run Firefox:
+
+   .. code::
+
+     	sudo apt update
+     	sudo apt install libgtk-3-0 libasound2 libx11-xcb-dev