More setup instructions

CONTRIBUTING.md

@@ -12,8 +12,7 @@ and reviews of proposed changes are all welcome.
 By contributing,
 you agree that we may redistribute your work under [our license](LICENSE.md).
 In exchange,
-we will address your issues,
-assess your change proposal,
+we will address your issues and/or assess your change proposal as promptly as we can,
 and help you become a member of our community.
 Everyone involved in [Software Carpentry][swc-site] and [Data Carpentry][dc-site]
 agrees to abide by our [code of conduct](CONDUCT.md).

index.md

@@ -5,7 +5,9 @@ This lesson shows how to use the
 [Software Carpentry]({{ site.swc_site }}) and
 [Data Carpentry]({{ site.dc_site }}) lesson template.
 For guidelines on how to help improve our lessons and this template,
-please see [the contribution guidelines][contributing].
+please see [the contribution guidelines][contributing];
+for guidelines on how to set up your machine to preview changes locally,
+please see [the setup instructions](/setup/).
 
 > ## Prerequisites
 >

setup.md

@@ -14,21 +14,21 @@ permalink: /setup/
 
 If you want to set up Jekyll
 so that you can preview changes on your own machine before pushing them to GitHub,
-you must do the following:
+you must install the software described below.
+(Note: Julian Thilo has written instructions for [installing Jekyll on Windows](http://jekyll-windows.juthilo.com/).)
 
-1.  Install Ruby.
+1.  **Ruby**.
     This is included with Linux and Mac OS X;
     the simplest option on Windows is to use [RubyInstaller](http://rubyinstaller.org/).
     You can test your installation by running `ruby --version`.
     For more information,
     see [the Ruby installation guidelines](https://www.ruby-lang.org/en/downloads/).
 
-2.  Install [RubyGems](https://rubygems.org/pages/download)
+2.  **[RubyGems](https://rubygems.org/pages/download)**
     (the package manager for Ruby).
     You can test your installation by running `gem --version`.
 
-3.  Install [Jekyll](https://jekyllrb.com/) by running `gem install jekyll`.
-
-Julian Thilo has written instructions for [installing Jekyll on Windows](http://jekyll-windows.juthilo.com/).
+3.  **[Jekyll](https://jekyllrb.com/)**.
+    You can install this by running `gem install jekyll`.
 
 [template]: {{ site.workshop_repo }}