From 2a6928847fd436e0e384f03d2511359125e66af0 Mon Sep 17 00:00:00 2001
From: Jan Schultke <me@eisenwave.net>
Date: Tue, 27 May 2025 08:19:30 +0200
Subject: [PATCH] Update README.rst

---
 README.rst | 28 ++++++++++++++++++++++++----
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/README.rst b/README.rst
index 4ab1c20b2d..7f4ede2b77 100644
--- a/README.rst
+++ b/README.rst
@@ -24,7 +24,7 @@ Install the `MacTeX distribution <http://tug.org/mactex/>`_.
 If you are on a slow network, you'll want to get the `BasicTeX package <http://tug.org/mactex/morepackages.html>`_ instead,
 then run the following command to install the other packages that the draft requires:
 
-   sudo tlmgr install latexmk isodate substr relsize ulem fixme rsfs extract layouts enumitem l3packages l3kernel imakeidx splitindex xstring
+   ``sudo tlmgr install latexmk isodate substr relsize ulem fixme rsfs extract layouts enumitem l3packages l3kernel imakeidx splitindex xstring``
 
 ---------------------------------------
 Getting Started on Debian-based Systems
@@ -32,7 +32,7 @@ Getting Started on Debian-based Systems
 
 Install the following packages:
 
-   sudo apt-get install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern
+   ``sudo apt-get install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern``
 
 -------------------------
 Getting Started on Fedora
@@ -40,7 +40,7 @@ Getting Started on Fedora
 
 Install the following packages:
 
-   dnf install latexmk texlive texlive-isodate texlive-relsize texlive-ulem texlive-fixme texlive-extract texlive-l3kernel texlive-l3packages texlive-splitindex texlive-imakeidx
+   ``dnf install latexmk texlive texlive-isodate texlive-relsize texlive-ulem texlive-fixme texlive-extract texlive-l3kernel texlive-l3packages texlive-splitindex texlive-imakeidx``
 
 -----------------------------
 Getting Started on Arch Linux
@@ -48,7 +48,7 @@ Getting Started on Arch Linux
 
 Install the following packages:
 
-   pacman -S make texlive-latexextra texlive-binextra texlive-plaingeneric texlive-fontsrecommended
+   ``pacman -S make texlive-latexextra texlive-binextra texlive-plaingeneric texlive-fontsrecommended``
 
 -----------------------------
 Getting Started on Microsoft Windows
@@ -59,6 +59,10 @@ See `sample instructions <https://bennierobinson.com/programming/2016/01/24/perl
 
 Install `MiKTeX <https://miktex.org/download>`_
 
+Alternatively, you can `install WSL <https://learn.microsoft.com/en-us/windows/wsl/install>`_
+and a Linux distribution,
+and follow the instructions for Linux above.
+
 ------------
 Instructions
 ------------
@@ -80,6 +84,22 @@ For example::
 
    make figvirt.pdf
 
+Verifying input and output when making changes
+==============================================
+
+While in the ``source`` directory,
+you can check for common mistakes such as misaligned comments with::
+
+    ../tools/check-source.sh
+
+After typesetting the document,
+you can also check the output for further problems with::
+
+    ../tools/check-output.sh
+
+GitHub Actions will also run these checks when you create a pull request,
+but it's often faster if you run them locally first.
+
 ----------------
 Acknowledgements
 ----------------