Added comments and tidied package setup.

wsl-setup.org

@@ -11,19 +11,26 @@ This guide will walk through setting up [[https://en.wikipedia.org/wiki/Windows_
 *Acknowledgements:* Large elements of this wsl setup came about through collaboration with the great people at [[https://ii.coop][ii.coop]].  I encourage you to explore and contribute to their work on [[https://gitlab.ii.coop][gitlab]] as many elements form a core part of this setup and workflow.
 
 
-* Setup home folder structure
+** Setup home folder structure
 
-  This section sets up my preferred set of initial folders inside my home directory.
+   After installing the Debian WSL distribution no folders are present in your home folder.
+   
+   In this section we create some quick standard folders to keep our home folder somewhat organised.
 
    #+NAME: Setup home folder strucuture
    #+BEGIN_SRC shell
+   # Ensure we are in our home folder
    cd ~/
+   
+   # Create a documents folder for our git repositories
    mkdir Documents
+
+   # Create a downloads folder for temporary objects
    mkdir Downloads
    #+END_SRC
 
 
-* Update and install packages
+** Update and install packages
 
    To get started we ensure the package manager is up to date.
 
@@ -44,7 +51,7 @@ This guide will walk through setting up [[https://en.wikipedia.org/wiki/Windows_
    # Install pre-requisites for compiling emacs
    sudo apt-get install -y make gcc libgnutls28-dev libtinfo-dev
   
-  # Install dpkg management tools
+   # Install dpkg and apt management tools
    sudo apt-get install -y software-properties-common apt-transport-https ca-certificates
 
    # Install terminal customisation packages
@@ -52,30 +59,46 @@ This guide will walk through setting up [[https://en.wikipedia.org/wiki/Windows_
    #+END_SRC
 
 
-  We use [[https://pandoc.org/][pandoc]] for documentation export from spacemacs.
+   We use [[https://pandoc.org/][pandoc]] for documentation export from spacemacs and other markup conversion tasks.
 
    #+NAME: Install pandoc
    #+BEGIN_SRC shell
-  curl -L -O https://github.com/jgm/pandoc/releases/download/2.7.3/pandoc-2.7.3-1-amd64.deb  
+   # Work from our downloads folder
-  sudo dpkg -i /tmp/pandoc-2.7.3-1-amd64.deb
+   cd ~/Downloads
+
+   # Download the latest release (check if newer is available)
+   curl -L -O https://github.com/jgm/pandoc/releases/download/2.9/pandoc-2.9-1-amd64.deb  
+   
+   # Install the package with dpkg
+   sudo dpkg -i pandoc-2.9-1-amd64.deb
    #+END_SRC
 
 
-  For additional package management we use node. The code below installs node ~12~.
+   For additional package management we use [[https://www.npmjs.com/][node package manager]]. The code below installs node ~12~.
 
    #+NAME: Install node
    #+BEGIN_SRC shell 
+   # Curl down the shell script for adding version 12 of nodejs to apt
    sudo curl  -sL https://deb.nodesource.com/setup_12.x | sudo bash -
+   
+   # Install the nodejs package via apt
    sudo apt-get install -y nodejs
    #+END_SRC
 
   
    For managing secrets we use [[https://bitwarden.com/][bitwarden]] which provides a great [[https://github.com/bitwarden/cli][cli utility]].
 
+   This section should be expanded in future to cover setting alias for common bitwarden tasks.
+
    #+NAME: Install bitwarden and login
    #+BEGIN_SRC shell
+   # Set an environment variable with our login email for bitwarden
    export account=[BITWARDEN_ACCOUNT]
+
+   # Install the bitwarden cli via node package manager
    sudo npm install -g @bitwarden/cli 
+
+   # Test login to bitwarden
    bw login $account
    #+END_SRC
 
@@ -112,16 +135,13 @@ This guide will walk through setting up [[https://en.wikipedia.org/wiki/Windows_
    rm *amd64.zip 
    #+END_SRC
 
-  #+RESULTS:
-  | Archive:   | terraform_0.12.9_linux_amd64.zip |
-  | inflating: | terraform                        |
 
-
+   For ad-hoc system administration we use [[https://deb.nodesource.com/setup_12.x ][ansible]].
-  For ad-hoc system administration we use ansible
 
    #+NAME: Install ansible
    #+BEGIN_SRC shell
-  sudo yum install -y ansible
+   # Install ansible via apt package manager
+   sudo apt-get install -y ansible
    #+END_SRC