diff --git a/site/_docs/upgrading.md b/site/_docs/upgrading.md
index 0736d879..9601576f 100644
--- a/site/_docs/upgrading.md
+++ b/site/_docs/upgrading.md
@@ -24,14 +24,15 @@ $ gem update jekyll
For better clarity, Jekyll now accepts the commands `build` and `serve`.
Whereas before you might simply run the command `jekyll` to generate a site
-and `jekyll --server` to view it locally, in v2.0 (and later) you should use the subcommands `jekyll build`
+and `jekyll --server` to view it locally, in v2.0 (and later) you should use
+the subcommands `jekyll build`
and `jekyll serve` to build and preview your site.
Watching and Serving
With the new subcommands, the way sites are previewed locally
changed a bit. Instead of specifying `server: true` in the site's
- configuration file, use `jekyll serve`. The same hold's true for
+ configuration file, use `jekyll serve`. The same holds true for
`watch: true`. Instead, use the `--watch` flag with either `jekyll serve`
or `jekyll build`.
@@ -43,8 +44,10 @@ subdirectories. Starting with v2.0, absolute permalinks are opt-out,
meaning Jekyll will default to using absolute permalinks
instead of relative permalinks.
-* To use absolute permalinks, set `relative_permalinks: false` in your configuration file.
-* To continue using relative permalinks, set `relative_permalinks: true` in your configuration file.
+* To use absolute permalinks, set `relative_permalinks: false` in
+your configuration file.
+* To continue using relative permalinks, set `relative_permalinks: true` in
+your configuration file.
Absolute permalinks will be default in v2.0 and on
@@ -84,7 +87,7 @@ to one or more config files (comma-delimited, no spaces).
* `--no-server`
* `--no-auto`
-* `--auto` (now `--watch`)
+* `--auto` (now `--watch` and `--no-watch`)
* `--server`
* `--url=`
* `--maruku`, `--rdiscount`, and `--redcarpet`
@@ -106,8 +109,8 @@ to one or more config files (comma-delimited, no spaces).
### New Config File Options
Jekyll 1.0 introduced several new config file options. Before you upgrade, you
-should check to see if any of these are present in your pre-1.0 config file, and
-if so, make sure that you're using them properly:
+should check to see if any of these are present in your pre-1.0 config file,
+and if so, make sure that you're using them properly:
* `excerpt_separator`
* `host`
@@ -124,7 +127,8 @@ Often, you'll want the ability to run a Jekyll site in multiple places, such as
previewing locally before pushing to GitHub Pages. Jekyll 1.0 makes that
easier with the new `--baseurl` flag. To take advantage of this feature, first
add the production `baseurl` to your site's `_config.yml` file. Then,
-throughout the site, simply prefix relative URLs with `{% raw %}{{ site.baseurl }}{% endraw %}`.
+throughout the site, simply prefix relative URLs
+with `{% raw %}{{ site.baseurl }}{% endraw %}`.
When you're ready to preview your site locally, pass along the `--baseurl` flag
with your local baseurl (most likely `/`) to `jekyll serve` and Jekyll will
swap in whatever you've passed along, ensuring all your links work as you'd