minor README updates

Author: t-bltg

README.md

@@ -5,27 +5,35 @@ Documentation for [Plots.jl](https://github.com/JuliaPlots/Plots.jl)
 ## Editing the Docs
 
 To edit the documentation, simply edit the Markdown files in [docs/src](https://github.com/JuliaPlots/PlotDocs.jl/tree/master/docs/src). [Documenter.jl](https://github.com/JuliaDocs/Documenter.jl) will automatically rebuild the documentation when changes are merged to master.
-The new documentation files will be pushed to the [`gh-pages`](https://github.com/JuliaPlots/PlotDocs.jl/tree/gh-pages) branch in this repository (useful for debugging the `Plots.jl` documentation  build through CI). When building new docs for a release (e.g. `1.Y.Z`), don't forget to manually delete the previous patch version in `gh-pages` (`1.Y.(Z - 1)`), thus avoiding filling up the deployment quota of `10Gb` imposed by `github`.
+
+The new documentation files will be pushed to the [`gh-pages`](https://github.com/JuliaPlots/PlotDocs.jl/tree/gh-pages) branch in this repository (useful for debugging the `Plots.jl` documentation  build through CI).
+
+When building new docs for a release (e.g. `1.Y.Z`), don't forget to manually delete the previous patch version in `gh-pages` (`1.Y.(Z - 1)`), thus avoiding filling up the deployment quota of `10Gb` imposed by `github`.
 
 ## Building the docs
 
-With proper dependencies installed, run the following on your local terminal `$ CI=true julia --project=docs docs/make.jl`.
+With proper dependencies installed, run the following on your local terminal:
+```bash
+$ CI=true julia --project=docs docs/make.jl
+```
 
 Setting the environment variable `CI=true` is optional, but the result will be closer to the remote docs building process.
 
-To only build part of the documentation (faster dev), use `PLOTDOCS_BACKENDS='GR PyPlot'` and / or `PLOTDOCS_EXAMPLES='1 22 60'` environement variables. 
+To only build part of the documentation (faster dev), use the following envionment variables:
+- `PLOTDOCS_BACKENDS='GR PyPlot'` to select backends;
+- `PLOTDOCS_EXAMPLES='1 22 60'` to select gallery examples. 
 
 ## Contributing demos
 
 The demos are valid julia scripts written with [Literate markup syntax][literate_syntax] and managed
 by [DemoCards.jl][democards_jl]. The following steps shows a common workflow to add demos:
 
 1. create your julia script in any sub-folder in `docs/user_gallery/`. For instance,
-   `docs/user_gallery/misc/gr_lorenz_attractor.jl`.
+   `docs/user_gallery/misc/gr_lorenz_attractor.jl`;
 2. configure the demo using [DemoCards YAML frontmatter][yaml_frontmatter]. You may also check how
-   other demos are configured as a reference.
-3. write the demo in Julia with the Literate markup syntax.
-3. activate the docs environment and add `PlotDocs.jl` to the environment via `import Pkg; Pkg.activate("docs"); Pkg.develop(".")`
+   other demos are configured as a reference;
+3. write the demo in Julia with the Literate markup syntax;
+3. activate the docs environment and add `PlotDocs.jl` to the environment via `import Pkg; Pkg.activate("docs")`;
 4. preview the demo using [`DemoCards.preview_demos` feature][democards_preview]. For instance, you
    can partially build one single file via
    `preview_demos("docs/user_gallery/misc/gr_lorenz_attractor.jl")`, or the entire section via